Skip to content
GitHub

Automatic Sync

Automatic sync keeps your game library current without you having to run an import. Once enabled for an account, Masterboard checks chess.com or Lichess in the background and imports any new games it finds — routed straight into a folder and collections you choose, with opening deviations already detected.

This is separate from the manual Import dialog: manual import is for pulling in a specific date range of past games, while automatic sync handles everything you play from now on.

Auto-sync is configured per account in Settings → Connected accounts.

  1. Open Settings and find the Connected accounts section.
  2. Click the Lichess or Chess.com row to expand it, and set your username (for Lichess you can also connect via OAuth). A username is required before auto-sync can be turned on.
  3. Toggle Auto-sync on. Masterboard offers to import your past games as well — choose Import past games to open the regular import tool, or Not now to sync only future games.

When auto-sync is on, the expanded account row shows its settings:

  • Check every — how often Masterboard polls for new games, in hours (default 6). It also runs a check shortly after the app launches.
  • Time controls — toggle Bullet, Blitz, Rapid, Classical, and Correspondence. With none selected, all time controls are synced.
  • Filters
    • Rated only — skip casual games.
    • Min. moves — ignore games shorter than this many moves (useful for filtering out instant resignations and aborts).
  • Save to folder — the folder new games are placed in (or No folder).
  • Collections — optionally tag every synced game with one or more collections.

Changes are saved as you make them. Use Sync now to run an immediate check instead of waiting for the next interval.

After each sync that imports games, Masterboard shows a toast: “N new games imported, M have opening deviations.” (Runs that import nothing stay silent.)

Synced games are indexed immediately, so any opening deviations — positions where a game left your prepared repertoire — are detectable right away, with no analysis required. Engine analysis is not triggered automatically; run automated analysis yourself when you want accuracy figures and tactics.

The account row shows the last synced time, or an error message if the most recent check failed (for example, an unreachable server or an unknown username).