Importing your games

Connecting your accounts

The Accounts menu in the library toolbar links Régence to your platforms. Look up a username… adds an account with two fields — the platform and the username — and two options:

  • Save: the account becomes permanent. Its games appear in the library, month by month.
  • Session only: the account is ephemeral, forgotten at restart — perfect for browsing an opponent’s games, or an intriguing player, without cluttering your library.

There’s no one-account-per-platform limit: a main account, a club account, an old username — they all coexist, and checking or unchecking an account in the menu filters its games in the table. Manage accounts… opens Settings for the deeper housekeeping: main account (it orients the board), activation, and the link with Lichess.

Linking with Lichess

Lichess additionally requires a personal token for two services: the opening explorer, which refuses anonymous requests, and importing your private studies. Régence gets it for you.

In Settings > Accounts, the Connect my Lichess account button opens lichess.org in your browser: you authorize Régence, and the token comes back into the app on its own — stored in the macOS keychain, as it should be. The section then reads Connected, with a Sign out button to switch accounts.

One single permission is requested: study:read, the one that allows reading your private studies. Nothing else — Régence never writes to your Lichess account.

Browsing and bringing home

Once an account is active, the month selector in the toolbar loads the archives: “All months” shows the paginated feed (the Load more button goes back in time), a specific month loads all its games at once — clocks included.

Online games can be browsed directly; Add to My games, in the selection bar, saves them to the local library — that’s where they become batch-analyzable, taggable and counted in statistics. To see the online feed alone, without your saved games mixed in, pick the Online games place in the sidebar; the Not imported only filter in the Filters menu then isolates what’s left to bring over.

The Import menu in the same toolbar carries the two classics: a PGN file (one game or a hundred — a multi-game file imports whole) and a Lichess or chess.com game URL. Dragging a PGN file onto the window works too, as everywhere in Régence.