GOG Dormant Game Sweep#

Automated workflow: find installed GOG games not played recently → email report → add Apple Reminders.

Quick Start#

bash

python3 scripts/sweep.py --library config/gog_library.json --email john.doe@example.com

Script: scripts/sweep.py#

Arguments#

FlagDefaultDescription--library``config/gog_library.jsonPath to GOG library JSON--days``30Dormancy threshold (days)--emailNoneRecipient email (required unless --no-email)--himalaya-account``personalHimalaya account to send from--reminders-list``GamingApple Reminders list name--no-emailfalseSkip email--no-remindersfalseSkip reminders--dry-runfalsePrint report only, no side effects

Library JSON Format#

Expects the same schema as config/gog_library.json: an object with a games array where each game has name, installed (bool), last_played (ISO 8601 or null), and install_path.

Workflow#

1. Parse library JSON → filter installed: true games where last_played is older than --days (or null/never)
2. Compose email body with game list and send via himalaya message write
3. For each dormant game, run remindctl add --title "Consider uninstalling: <name>" --list <list>

Example#

Full run with all options:

bash

python3 scripts/sweep.py \
  --library config/gog_library.json \
  --days 30 \
  --email john.doe@example.com \
  --himalaya-account personal \
  --reminders-list Gaming

Dry run to preview:

bash

python3 scripts/sweep.py --dry-run --days 60