FAQ
Where is my data stored?
Section titled “Where is my data stored?”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.
| Platform | Location |
|---|---|
| Windows | %APPDATA%\Masterboard\ |
| macOS | ~/Library/Application Support/Masterboard/ |
| Linux | ~/.config/Masterboard/ |
The database file is masterboard.db in that folder.
How do I back up my games?
Section titled “How do I back up my games?”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.
Can I use my own Stockfish?
Section titled “Can I use my own Stockfish?”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.
Can I import games from ChessBase?
Section titled “Can I import games from ChessBase?”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.
Does Masterboard connect to the internet?
Section titled “Does Masterboard connect to the internet?”Only for features that need it:
- importing games from chess.com or Lichess, including automatic sync
- checking for a new version of Masterboard, when you ask it to in Settings
- downloading engines and the master database
- Cloud Sync and the Cloud locker, if you sign in
Masterboard does not send telemetry, crash reports, or analytics. See the Privacy Policy for details.
Is Masterboard free?
Section titled “Is Masterboard free?”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:
- An
engines/folder in the same directory as the Masterboard binary. - Your system PATH.
If neither is found, the engine panel stays blank. Fix:
- On Windows: place
stockfish.exein anengines/folder next toMasterboard.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.
Can I sync my games across devices?
Section titled “Can I sync my games across devices?”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.