Skip to content
GitHub

First Game Import

Masterboard can import games from five sources: chess.com, Lichess, Lichess Studies, individual PGN files, and entire folders of PGN files. All of them start from the Import menu on the Games page. (This guide covers the most common three; see Importing Games for Lichess Studies and folder import.)

Go to the Games page (left sidebar) and click the Import menu in the top-right corner. It lists every import source.

  1. From the Import menu, choose From Chess.com… or From Lichess….
  2. Enter your username. If you have saved it in Settings → Connected Accounts, it will be pre-filled.
  3. Choose a date range (e.g. the last 3 months) and select the time controls you want to include (Bullet, Blitz, Rapid, Classical, Correspondence).
  4. Click Preview. Masterboard fetches and shows a list of matching games.
  5. Select the games you want — use the checkbox at the top to select all — then click Import.
  1. From the Import menu, choose PGN file….
  2. Pick a .pgn file in the file dialog. Both single-game and multi-game PGN files work.
  1. From the Import menu, choose PGN folder….
  2. Pick a directory in the file dialog. All .pgn files in the folder are imported.

Folder import is recursive — subfolders are included. Deduplication applies per game, so a file appearing in multiple places is only stored once.

Imported games appear in the Games list. ECO classification is applied automatically to any game that did not have an [ECO] header.