full-count / Docs / Saves & exports

Saves & exports

full-count keeps all of your data in a single directory under your home folder: ~/.full-count/. Nothing is written anywhere else, and nothing is ever uploaded.

~/.full-count/
├── saves/       # JSON game saves
└── exports/     # HTML scorecards

Save files

Press F2 during scoring to open the save prompt. Type a name, press Enter, and the current game state (plus every snapshot for replay) is written to ~/.full-count/saves/<name>.json.

Name sanitization

• Leading and trailing whitespace is trimmed.
• Spaces are replaced with hyphens.
• Names are capped at 64 characters.
• Only letters, digits, hyphens, and underscores are kept.
• Empty names are rejected.

For example, Cubs vs Sox — 2026-04-22 becomes Cubs-vs-Sox--2026-04-22.json.

Resuming

full-count --load cubs-vs-sox           # bare name, looked up in ~/.full-count/saves/
full-count --load cubs-vs-sox.json      # with extension — same lookup
full-count --load ./backups/cubs.json    # relative path — used as-is
full-count --load /abs/path/cubs.json    # absolute path — used as-is

Lookup order when the argument is a bare name or filename:

1. If the argument exists on disk as-is, use it.
2. Otherwise look inside ~/.full-count/saves/.
3. If there's no extension, also try appending .json.
4. If none of those exist, proceed to the load call so you get a clear error.

Save file format

Save files are plain JSON — human-readable, diff-friendly, and stable enough to be edited by hand if you really want to. A save contains two top-level fields:

• game — the current GameState (teams, lineups, inning, runners, stats).
• snapshots — an ordered list of historical GameStates, one per scored event, used for replay.

HTML scorecard export

When you end a game (X from the scoring screen) you land on the summary screen. From there you can export a paper-style HTML scorecard that looks like a traditional printed scorebook.

Exports are written to ~/.full-count/exports/<away>-vs-<home>.html. Open it in any browser and hit Ctrl/Cmd + P if you want to print it.

The scorecard renders:

• Team names, team colors, date.
• Inning-by-inning R/H/E line score.
• A batting grid with one at-bat per cell using standard scorecard symbols (1B, K, 6-3, …), color-coded by event class.
• Per-batter totals and per-pitcher decisions (W/L/S).