VisionChess

Bottom menu buttons

• Scan — Detects the board automatically. Use it once at the start, with an empty board or pieces in their starting position. The app maps the 64 squares onto the camera view so it knows what's where.
• Start — Begins the game: starts both clocks and starts recording moves in standard chess notation. Tap again to stop.
• Board — Switch to a different chess set model (e.g. Pokemon, Drago, H.C. Andersen). Models can be downloaded on demand.
• Correct — Lets you fix anything the AI got wrong on a square. Your corrections help the model improve for everyone.
• Moves — Shows the move list in chess notation, ready to copy or share as PGN to chess.com / lichess.

Status indicators (top bar)

• Help (?) — Toggle help mode. Tap any button to see a short explanation instead of triggering its action.
• Settings (⚙) — Opens the settings page (explained below).
• Board OK / Scanning / Failed — The current detection state. Green when the board is locked in, amber while scanning, red if detection failed.
• Tilt (📐 + degrees) — How tilted your phone is relative to the board. Aim for 60° or higher for best accuracy. Green ≥ 55° (good top-down angle). Yellow 50–54° (borderline — may miss back pieces). Red < 50° (too shallow, prop the phone higher).
• Fill (▢ + percent) — How much of the camera frame the board occupies. Higher fill = bigger pieces in the image = better detection. Use zoom (the +/− buttons on screen) to increase fill. Green > 40% (good size). Yellow ≤ 40% (zoom in, or move closer).

Audio

• Audio Setup — Assign custom sounds to each piece type. You can record your own voice ("pika pika!"), upload effects, or pick from defaults. Great fun for teaching kids.
• Turn Announcement — Speaks "White's turn" or "Black's turn" out loud after each move. Useful when you're not staring at the clock.
• Piece Move Audio — Plays a sound whenever a piece moves. Combine with Audio Setup to use your own custom sounds per piece.
• Clock Warning Audio — Plays a warning tone when a clock runs low on time. Helps you speed up without staring at the clock.

Gameplay

• Stability Frames — How many consecutive frames the board must look stable before the app accepts a change. Lower (2) is faster; higher (5) is more resistant to false positives from camera shake or hands moving over the board.
• Camera Perspective — Which corner sits at the bottom-right of your camera view. Pick this based on where you placed the phone: A-side, H-side, White player's seat, or Black player's seat. Most players put the phone on the side and use the default A-side.

Advanced

• Debug Overlay — Shows a small green text overlay on the camera view with FPS, detection count, and other internals. Useful when reporting issues.
• Board Addition — Shows the "Add New Board" button on the main screen, letting you contribute training images for a new chess set.
• Manual Board Detection — Adds a Manual button that lets you tap each of the four board corners (A1, H1, A8, H8) when automatic detection fails.