navig-games

Proactively find & auto-claim FREE games (Epic now; GOG/Amazon/Steam next) and manage your game library. FREE-ONLY: never spends real money.

Works on its own — its own CLI, no navig required · v0.11.0 · PyPI

On its own (no navig needed)

pip install navig-games
navig-games --help   # no navig needed

With navig

pip install "navig[games]"
navig games --help

Find & auto-claim FREE games across storefronts — surfaced as navig games. A first-party NAVIG plugin (free, toggleable). Phase 1 ships the Epic Games Store end-to-end; GOG, Amazon Prime Gaming and a Steam suite follow.

FREE-ONLY — never spends money. The claim engine only ever completes a $0 checkout. Any title with a real price is refused. Three independent gates enforce this: (A) the store API reports a $0 discounted price, (B) the store CTA reads "Get" (Epic never shows "Get" for a priced game), and (C) the checkout overlay total is re-read and must not show a positive amount before the order is placed. Any parse failure resolves toward refuse.

On its own

pip install navig-games              # adds the `navig-games` command
navig-games check                    # what's free right now across Epic, GOG, itch, Steam
navig-games library                  # every installed game across your launchers
navig-games unify                    # add them all to Steam, with cover art
navig-games deals                    # price drops + free-to-keep on your Steam wishlist
navig-games steam code               # a Steam Guard code from your stored secret

Settings live in the same config.yaml navig uses and Steam Guard secrets in the shared vault (navig-vault), so nothing moves when you install navig. Epic sign-in and auto-claim drive your installed Chrome through navig-browser, with the session saved in the same vault:

navig-games login epic               # one-time sign-in; the session is vaulted
navig-games claim --dry-run          # checks each freebie is $0 and stops before ordering

Only schedule needs navig (its daemon runs the jobs). Without navig, run navig-games claim --all --yes or deals notify from your own cron or Task Scheduler.

Quick start (inside navig)

# Free games (Epic)
navig games check                 # what's free right now (+ --upcoming, --json)
navig games login epic            # one-time sign-in; session saved to the vault
navig games claim --dry-run       # verify free & stop before ordering (proof)
navig games claim                 # claim the current freebies (confirm prompt)
navig games schedule enable       # auto-claim on a schedule (daily by default)

# Library (Steam / Epic / GOG / Amazon)
navig games library               # every installed game across your launchers
navig games unify                 # add your games to Steam (shortcuts.vdf) + cover art
navig games art <game>            # fetch/refresh Steam cover art (--all, --portrait, …)
navig games art --set-key <key>   # save a SteamGridDB key for full portrait grids
navig games deals                 # price drops + free-to-keep on your Steam wishlist
navig games schedule enable --job deals    # daily deal alerts (notify)
navig games schedule enable --job unify    # keep Steam synced with new installs
navig games doctor                # full self-check across every subsystem
navig games steam auth --mafile x # store a Steam Guard secret in the vault
navig games steam code            # current Steam Guard 2FA code

navig games history | status | doctor

How it works

Design notes

• The Epic claim flow and the Steam-library discovery are implemented natively — first-party code end-to-end, no third-party engine imported.
• First run requires navig games login epic once (Epic mandates a real sign-in); after that, claims restore the vaulted session with no password typed.
• Captcha / un-handleable 2FA stops the run and notifies "needs you" — it never loops or guesses.

Roadmap

• Phase 1 — Epic free-game auto-claim ✅
• Phase 4 — unify launchers into Steam · Steam Guard TOTP · cover art · wishlist deals watcher ✅
• Phase 2 GOG free-game claim · Phase 3 Amazon Prime Gaming claim
• Phase 4 (rest) — Steam achievements · cloud-save sync
• Phase 5 — deck/OS "Games" dashboard (free-game feed + deals + one-click unify)