Skip to content

About

Zipped PGNs of the Chesscom CCC

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

ccc-archive

Zipped PGNs of the Chesscom CCC.

Data and naming

ZIPs live in year folders. Each contains one matching PGN, for example 2026/ccc_2026-08-24_26-bullet-main.zip → ccc_2026-08-24_26-bullet-main.pgn. Filenames follow ccc_YYYY-MM-DD_<slug>[a|b|c…].(zip|pgn): the event start date plus a descriptive slug taken from the event name (the leading CCC label and any trailing (time control) are dropped, e.g. CCC 26 Bullet: Semifinals → 26-bullet-semifinals). A collision suffix a, b, c… is added only when the start date and slug both repeat. The manifest keeps the full start and end date range and the exact event name.

Import local event downloads

Preview selected files with Python 3.10 or later:

python scripts/import_pgn.py D:\dev\pgn\ccc2\event-501.pgn D:\dev\pgn\ccc2\event-503.pgn

Add --write to create canonical ZIPs and update ccc_manifest.json, ccc_links.txt, events.txt, and game_counts.txt. The importer leaves source files in place, refuses existing or overlapping archives, and verifies ZIP contents before updating metadata. Select only events not already imported. Pass --rebuild to rebuild the entire archive from a full set of source PGNs, replacing every existing ZIP (used for the one-time move to the ccc_YYYY-MM-DD_<slug> naming).

Date ranges use the earliest game start and latest game end, including files whose games are out of order. Bare Event-only placeholders are omitted from the archived copy and game counts. Valid game blocks, engine annotations, and * results are preserved. The import report identifies omitted placeholders.

Run the importer tests with python -m unittest discover -s scripts -p 'test_*.py'.

Publish this repository before refreshing Chess Nerd. Its page at https://chessnerd.net/ccc-archive.html reads this repository's published manifest on each site deployment. For a local site snapshot, run npm run sync:ccc in the Chess Nerd repository.

About

Zipped PGNs of the Chesscom CCC

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages