Game Graveyard

⭐ Gold Star Project I consider this project complete. Fixes, maintenance and good new ideas are still welcome. About Gold Stars

Keep a record of games you stopped playing, revisit your decisions and make a sharing copy without private reasons or notes.

Current release 1.3.1

Numeric fields reject values outside the finite float range with a normal input error, including JSON integers such as 10**400. Values are never clamped or silently replaced. Wheels and source distributions include the README, changelog, development/testing instructions, license and runnable examples.

Reports reject a playtime total outside that range; use smaller playtimes or a report filter. A single supported large value remains valid.

Updates in 1.3.0

Add --state and --due-only --as-of YYYY-MM-DD report filters. Counts and exports reflect the selection; decision files retain all records. An as-of report no longer lists a game for reconsideration before its abandonment date. Only abandoned or reconsidering games can be due; returned and not-yet-abandoned states are excluded. Authored dates and decision history remain unchanged.

Updates in 1.2.2

Recover cleanly when writing a report and its companion file fails.

Report and ledger/decision/history files are prepared together. If an ordinary write fails, the command removes only unchanged files it created, so you can fix the destination and retry. Existing files, source inputs and files changed by another process are preserved. Outputs are UTF-8 with LF endings. This handles ordinary write failures; it does not promise a multi-file transaction through power loss or recall text already read from stdout.

Updates in 1.2.1

Make a sharing copy without private reasons, notes or decision history.

Use game-graveyard graveyard.json --share-safe --format json --output share.json. Sharing copies contain only title, platform, broad reason category and current state. Review those fields too: a title or broad category may still be personal. Private source data stays unchanged. Sharing reports are clearly marked and cannot be used as a lossless backup or re-import file.

Updates in 1.1.1

Repair randomizer interchange and make CSV exports safe for spreadsheet viewing by default.

Use game-graveyard graveyard.json --format backlog --output backlog.json for a version 1 randomizer input. Ownership still defaults false and must be reviewed. CSV export prefixes formula-like text with an apostrophe by default; this changes those cells intentionally for spreadsheet viewing. --format csv --csv-lossless preserves exact cell text for trusted round trips and may contain executable spreadsheet formulas. Neither mode promises that an arbitrary spreadsheet program is safe; inspect exports before opening them.

Game Graveyard keeps intentionally abandoned games out of an active backlog without erasing the decision. A portable JSON record can retain the platform, attempts, approximate playtime, reason category, explanation, abandonment date, and an optional reconsideration date.

Three-minute start

python -m pip install .
game-graveyard examples/graveyard.json
game-graveyard examples/graveyard.json --reason technical --format json

Reports summarize entries by reason and platform, list scheduled reconsiderations separately, and support Markdown or JSON output. Existing report files are refused.

The tool does not import platform libraries, judge whether a game is good, or calculate playtime. The owner supplies every record and can choose deliberately broad notes for privacy. Requires Python 3.10 or newer.

Part of the Logan Pendragon Forge open-source collection. Licensed under the MIT License.

Version 1.1.0: reviewed improvements

Add reversible dated decisions, explicit reconsideration views and local CSV/backlog interchange while preserving original abandonment reasons.

game-graveyard examples/graveyard.json --as-of 2026-09-07 --format json

Use --decision abandoned|reconsidering|returned with --game-id, --date, --decision-note and --decision-output new.json. --undo-last appends a reversal instead of deleting history. Dates must remain ordered and original abandonment reasons are preserved. --as-of evaluates decision state and due reconsideration dates without scheduling reminders. CSV input/output carries documented fields and JSON history; unsupported extra columns are rejected. --format backlog creates a randomizer-compatible JSON with original graveyard_record metadata for re-import. Ownership is unknown and defaults false, so review backlog rules before drawing. Generic backlog records without authored abandonment metadata are rejected. No storefront login or notification is performed.

CSV rejects NUL characters consistently across supported Python versions; use JSON to retain those records. Ordinary whitespace/control prefixes before formula-like text are neutralized in spreadsheet-safe exports.

1.3.0 report controls

Use --state abandoned|reconsidering|returned|not_yet_abandoned to select the evaluated decision state. Use --due-only --as-of YYYY-MM-DD to select games due on a specific date. Filters combine with --reason and apply to report counts and all export formats, including sharing copies. Decision files retain the full record set; filters only select the report.