kifu.me support page
kifu.me is an assistant for entering backgammon match records. It helps you efficiently record games compared to manual entry.
Table of Contents
How to Use
- Upload your video
- Record the board properly (see Video Recording section for details)
- Maximum video size is 16GB
- If your match is split into multiple files, you can upload multiple files
- Files must be in sequential order
- You can upload up to 10 files in total
- Check the analysis results via email notification
- After analysis is complete, you will receive an email notification. Open the link provided in the email in your browser to review the analysis results. The link is valid for one week only.
- Receive the match record file by email
- Save the match data as needed and use it for analysis
- The match record is a text file. If there are any errors in the data, you can manually correct them using a text editor.
Dos and Don’ts
Video Recording
- Secure the camera firmly
- Record from directly above the board (recording from an angle is not supported)
- Adjust the frame to ensure the entire board is visible
- Record in Full HD (1920 x 1080 pixels)
- Use time-lapse video mode to significantly reduce upload time
- Recommended setting: 0.5 second interval
- Videos recorded with intervals longer than 1 second cannot be properly recognized
- Position the camera in landscape mode
- When using an action camera, use the distortion correction mode as lens distortion can interfere with recognition
Recording Examples
Good example: Recorded from directly above the board with the entire board visible
Example with significant lens distortion - Use distortion correction feature
Example recorded from the side - Position the camera directly above the board
Example recorded from the front - Position the camera directly above the board
Doubling Cube
- Place taken cubes visibly in the corner of the board
- kifu.me distinguishes between "center cubes" and "taken cubes" based on cube position
- Pause briefly (about 1 second) after deciding to take or pass
- This ensures enough time for image recognition. Stay calm and don't rush!
- Larger cubes reduce recognition errors (though this doesn't mean you should double more often!)
- Don't place unnecessary cubes near the board
- Multiple cubes in view can cause recognition errors
Dice
- Use chess clocks for your matches.
- If chess clocks are not available, share a single set of dice between players.
- kifu.me detects turn changes by recognizing when dice are picked up from the board. When each player uses their own dice, rapid rolling by the opponent may prevent proper recognition of turn changes.
- ELITE Precision Dice sold by Backgammon Galaxy have minimal light reflection, making them ideal for use with kifu.me.
- Dice with non-standard designs cannot be correctly recognized
- Example of dice not to use:
- Example of dice not to use:
Checkers
- kifu.me starts recording when it detects checkers returning to their initial positions
- If the initial setup is incorrect, the game won't be recorded properly
- Recognition accuracy decreases when checkers are stacked. Try to play without stacking checkers when possible
Board
- Boards with plain designs are optimal. Boards with text or illustrations can decrease recognition accuracy for cubes and dice
- Do not move the board during play
- If you need to move the board, do so after a game is finished and before setting up checkers for the next game
Match Record Review Guidelines
kifu.me records player moves using image recognition processing. Parts of the record that may be incorrect due to factors such as dice reflections or checker overlaps are marked with red highlighting. When reviewing the output match record, pay special attention to sections marked in red.
When Dice Rolls Are Highlighted in Red
In the example below, the dice roll read from image recognition was inconsistent with the actual play. Therefore, kifu.me corrected the read roll and marked it with red highlighting.
Dice rolls may be highlighted in red for the following reasons:
- Misrecognition due to dice reflection: Dice reflection caused the image recognition to produce incorrect results
- If the corrected roll matches the actual roll, no match record correction is needed
- Common mix-ups include 11 and 13, or 22 and 26
- Only one die recognized: When image recognition could identify only one of the two dice
- This is shown as 20, 50, etc. The roll needs correction
- Correction due to illegal moves: When actual play was an illegal move, the system corrected it to a different roll
- In this case, you need to correct the roll to the actual one
- Dance misrecognition: When dice are highlighted in red and the move shows “Cannot Move”
- This indicates cases where the roll recognized by kifu.me should not result in a dance. The roll needs correction
When Moves Are Highlighted in Red
In the example below, the number of checkers read from image recognition was inconsistent with the actual play. Therefore, kifu.me corrected the checker count and marked it with red highlighting.
In this example, the blue player played 13/6 and there are 6 checkers on the 6-point, but kifu.me recognized 5 checkers, so a correction was made.
Moves may be highlighted in red for the following reasons:
- Misrecognition due to checker overlap: When the apparent number of checkers appears low, the system corrected assuming checkers were overlapping
- ”????” display: Shown in the following cases:
- When a player resigned on the final move and no actual move was made
- When kifu.me could not find a consistent move with the recognized dice roll (possibly due to an illegal move)
Cube Actions
Objects other than the doubling cube (dice, checkers, watches, smartphones, etc.) may be mistakenly recognized as doubling cubes. In such cases, unnecessary cube actions are recorded and the game’s score record becomes incorrect, requiring correction.
Recommendation: Recording the score board alongside the game is recommended, as it allows you to check whether the score is correct when reviewing the match record.
FAQ
Q: My video file is larger than 16GB and I can't upload it.
A: You can use ffmpeg to reduce the file size.
The following command will create a video with reduced frames (2 frames per second), significantly decreasing the file size. When uploading this processed file, select the Normal Video option.
ffmpeg -i input.mp4 -vf "fps=2" output.mp4If ffmpeg is not installed on your system, you'll need to install it first. Visit the ffmpeg website for installation instructions.
Q: Will illegal moves be correctly recognized?
A: No. If there are illegal moves, one of the following will happen:
- The move won't be recognized, and "????" will appear in the match record
- The move will be recorded with a corrected dice roll different from the actual roll
In either case, manual correction will be necessary. For accurate records, try to avoid illegal moves.
Q: There is an incorrectly recorded game. Can I delete a specific game and get the match record?
A: It is not possible to delete a specific game and get the match record.
Useful Information
Please refer to the Tips on GitHub.
Known Issues
Please refer to the Issues on GitHub.
Flyer
