Skip to content
GitHub

FAQ

Masterboard stores all your data in a local SQLite database on your computer. If you use Cloud Sync, a copy of your synced data is also kept in your Masterboard account.

PlatformLocation
Windows%APPDATA%\Masterboard\
macOS~/Library/Application Support/Masterboard/
Linux~/.config/Masterboard/

The database file is masterboard.db in that folder.

All your games, repertoires, and training history live in a single SQLite database (masterboard.db) in the data folder above. To back up everything, copy that file to a cloud drive, external disk, or other safe location while the app is closed. Restore by copying it back.

To share or archive a single repertoire or an opponent report, use the PGN export actions in the Openings side-nav and on the Reports page.

Yes. Go to Settings → Engine Configuration, click + Add local engine…, and select your Stockfish binary. Any UCI-compatible engine works. See Engine Setup for details.

ChessBase can export to PGN: File → Export → PGN. Import the resulting file with Masterboard’s PGN import. All variations and annotations are preserved.

Can I open a .pgn file by double-clicking it?

Section titled “Can I open a .pgn file by double-clicking it?”

Yes. Masterboard registers as a handler for .pgn files on Windows, macOS, and Linux, so double-clicking a PGN file (or choosing Open with → Masterboard) opens it in the app. You can also import PGN files from inside the app — see Importing Games.

Only for features that need it:

Masterboard does not send telemetry, crash reports, or analytics. See the Privacy Policy for details.

Yes. Masterboard is free to download and use, including Cloud Sync and the Cloud locker.

The engine panel shows nothing — what’s wrong?

Section titled “The engine panel shows nothing — what’s wrong?”

Masterboard looks for a Stockfish binary in two places at startup:

  1. An engines/ folder in the same directory as the Masterboard binary.
  2. Your system PATH.

If neither is found, the engine panel stays blank. Fix:

  • On Windows: place stockfish.exe in an engines/ folder next to Masterboard.exe.
  • On macOS/Linux: install Stockfish system-wide (brew install stockfish, apt install stockfish) or add it with + Add local engine… in Settings → Engine Configuration.

See Engine Setup for more detail.

Analysis is very slow — how do I speed it up?

Section titled “Analysis is very slow — how do I speed it up?”

Increase the thread count in Settings → Engine Configuration to use more CPU cores. A good setting is (number of logical CPU cores − 1).

Also check that no other CPU-intensive applications are running while analysis is in progress. Batch analysis of many games is best run in the background while you step away.

Yes. Create a free account in Settings → Cloud Sync and your repertoires, training progress and settings stay in step across your computers. Games move between computers through the Cloud locker. See Cloud Sync.

Why does Windows show a security warning on first launch?

Section titled “Why does Windows show a security warning on first launch?”

The Windows installer on the download page isn’t code-signed yet, so Windows SmartScreen may warn about it. Click More info → Run anyway to continue — see Installation. The macOS app is signed and notarized by Apple, and the Linux AppImage runs without a warning.