Database Management

Your whole library — matches, stars, notes, tags, saved presets — lives in your browser's storage on this device. Nothing is on a server. This page covers managing it: setting your profile, deleting matches, and backing the lot up.

Profiles

A profile is you — the identity BackgammonDB uses to decide which side of each match is yours. It's a (name, level) pair, not just a name: the same name as a human and at a particular computer level count as distinct profiles, so your own games and your bot's never get pooled together.

• BackgammonDB auto-detects your most-frequent human profile the first time it loads a library.
• Switch profiles from the top bar, or by clicking any player name in the dashboard's Database Overview. The app lists every distinct profile it found, with a match count.

Your profile drives the parts of the app that need to know which side is "you":

• The dashboard scopes to your matches.
• The positions browser is framed around your profile — its scope control (the "{profile} is…" selector: on-roll, off-roll, at the table, or not relevant) decides whether you're looking at your own decisions, your opponents', either side, or the whole library.
• The "your errors" filters and per-player PR read from your seat.
• In review, your side is drawn primary. You can still flip to the opponent's perspective at any time with the V key.

Deleting matches

To delete individual matches, open a match in the matches view and use the delete button in its preview pane. It removes the match, its entry in the library index, its positions from the search index, and all stars, notes, and tags attached to it. Deletion is permanent.

Backup & restore

The Database Overview on the dashboard has Export and Import buttons that move your entire library as a single .bgdb file.

Export writes everything that's yours:

• every match (XG and SGF) with full analysis,
• stars, notes, and custom tags,
• saved presets.

What it doesn't include is device-level preferences: your settings (thresholds, theme, layout) and your selected profile stay on the machine and don't travel in a backup.

Import replays a .bgdb file. Two things to know:

• It's a full replace, not a merge: importing wipes the current library and restores the backup in its place. Importing the same file twice leaves you with the same library.
• BackgammonDB confirms before deleting anything, offers to download a backup of your current library first, and automatically rolls back to your previous library if the import fails partway through. Older backups are upgraded to the current schema automatically on import.

To move your library to a new machine: export on the old one, then import the .bgdb on the new one.