Skip to content

Repository files navigation

Humble Steam Key Redeemer

Rescue your Humble Bundle key backlog. A free, open source web app that runs entirely on your own machine. It finds every key you've ever bought, claims your unclaimed Humble Choice games, redeems everything you don't already own on Steam, warns you before keys expire, and rounds up your duplicate keys so you can give them away.

Latest release License: MIT Platforms Ko-fi

Demo

Quick start

  1. Download the latest release for your OS (Windows .exe, macOS zip, Linux tar.gz). No install, no Python needed. On Windows you can grab the portable HumbleRedeemer.exe or run HumbleRedeemer-<version>-Setup.exe for a proper Start Menu install with an uninstaller.
  2. Run it. The dashboard opens at http://127.0.0.1:5757 in whatever browser you use (Chrome, Firefox, Opera GX, anything).
  3. Sign in to Humble and Steam from the header chips (2FA/Steam Guard supported), then hit ▶ Full auto run.

On Windows the app lives in the system tray (blue key icon by the clock): closing the browser tab just "minimizes" it. The app keeps running in the background, and reopening http://127.0.0.1:5757 (or double-clicking the tray icon) brings it right back. Quit from the tray icon's menu or the ⏻ chip in the dashboard. Prefer a plain console window instead? Untick Run in the system tray in Settings.

The Humble automation runs in a separate hidden browser using Chrome or Firefox; if neither is installed, Selenium usually downloads a private copy of Chrome automatically. Windows builds are signed (publisher: Charles Chambers). macOS builds are unsigned, so right-click and Open the first time.

What it does

  • Metrics dashboard. Key pipeline, per service breakdown, redemption activity over time.
  • Full auto mode. Claim Choice games, sync Humble, sync Steam, match ownership, reveal and redeem every unowned key, then verify licenses, riding out Steam's rate limits with a countdown.
  • Three tier ownership matching. Steam AppID, then normalized names (™/®/case/punctuation), then a conservative fuzzy pass whose "likely owned" hits you confirm with one click.
  • Humble Choice auto-claim. Walks every Choice/Monthly month you've ever had and claims everything unclaimed.
  • Expiration tracking. Keys with Humble deadlines get flagged before they die.
  • Steam license verification. Confirms your redeemed keys actually landed on your account, and stamps each spare with where the game's ownership actually came from.
  • Giveaway page. Finds your duplicates (keys for games you already own that were never consumed) and tells you which spares are genuinely safe to give away: license provenance traces whether the "spare" key is probably the very key that bought you the game. Click to copy, email drafts, a Reddit post generator, a names only list for DM giveaways, Humble gift link creation, and tracking for what you've given away.
  • Steam inventory page. Scans your trading cards, backgrounds, emoticons, boosters and gems, pulls market prices, and lets you queue and list sales (one mobile confirmation per batch, or auto-confirm with your identity_secret). Proceeds are Steam wallet funds and Steam takes about 13%.
  • Attention page. Everything that can't auto-redeem: other-store keys with links for where to redeem them, dead keys with the Steam error decoded, expired keys, and the weird non-game stuff.
  • GOG keys. Tracked, matched, and listed with redeem links in the Attention page. The GOG sign-in and automatic redemption are switched off in this build while I rework them; redeem GOG keys by hand at gog.com/redeem for now.
  • Library browser. Search and filter all your keys by state, with bulk reveal/redeem/reset.
  • Runs in the system tray (Windows). Close the tab and it keeps working; update banners tell you when a newer version is on GitHub.
More screenshots

Dashboard (dark) Dashboard dark

Dashboard (light) Dashboard light

Library Library

Giveaway page Giveaway

Attention page Attention

Updates

The app checks this GitHub repo once at launch (a read-only fetch of public repo info, nothing about you is sent) and shows a banner when a newer release is out. You can silence it per-update ("remind me when the next one lands") or forever, from the banner or Settings → Updates. Set APP_NO_UPDATE_CHECK=1 to disable all update checking.

The installed Windows build can update itself. Hit Update now on the banner: it downloads that release's installer, checks it against the release's published SHA256 and against the Authenticode signature Windows sees on it (publisher: Charles Chambers), and only then offers to run it. A download that fails either check is deleted, not run, and the banner tells you why. The app closes while the installer works and reopens on its own afterwards. Your keys, history and sign-ins are not in the program folder, so they survive the whole thing. Running from source, or the portable exe? There is nothing to install for you, so the app says so and points you at git pull or the releases page instead of pretending.

Emergency releases override silencing: if update_notice.json in this repo has emergency: true, every running app that's behind shows a red banner with that notice's title/message explaining why the update can't wait (security fixes, breakage that could waste keys). It disappears as soon as you're up to date.

Privacy

Everything runs locally. No server, no accounts, no telemetry, no data collection. Your logins are stored as session cookies in local files (.humblecookies, .steamcookies), and your keys/history live in a local SQLite database (redeemer.db). If you ran the installer, those files live in %LOCALAPPDATA%\HumbleRedeemer, which is deliberately outside the program folder so updating the app can never touch them. If you run the portable exe or from source, they sit next to the app as before, and the app moves them for you if you later switch to the installer. Set HUMBLEREDEEMER_DATA to put them anywhere you like. The only network connections it ever makes are to Humble Bundle and Steam, acting as you, on your machine, for you, plus a read-only GitHub version check at launch (disable with APP_NO_UPDATE_CHECK=1). Delete the cookie files to sign out; delete redeemer.db to wipe all history.

Disclaimer

This is an unofficial tool, not affiliated with or endorsed by Humble Bundle, Valve/Steam, or GOG. It automates actions on your own accounts (fetching your library, revealing and activating your keys); automated account access may conflict with those services' terms of service. Use at your own risk. The software is provided as is, with no warranty of any kind, and you are solely responsible for your accounts and keys. Originally inspired by FailSpy's humble-steam-key-redeemer, since fully rewritten.

Running from source

Packaged builds need nothing installed. From source, you need Python 3.10+:

pip install -r requirements.txt
python app.py

On Windows, run_app.bat launches it windowless in the system tray (output goes to app.log); run_app_debug.bat keeps a console window with live logs. Optional: pip install python-Levenshtein makes the fuzzy matching faster.

Support

Enjoying this? If it rescued your key library, consider helping me afford more treats for these animals who love each otherrrr (see below). A $5 Ko-fi donation also gets you 5 random games from my list of excess keys; $10 or more and you pick your 5. Leave your picks in the Ko-fi comment and I'll message you the keys.

Puppy and cat tax

The animals in question. They love each otherrrr.

A golden dog resting its head on a tabby cat, both squished into the same cushion A tabby cat on a leash with a golden dog holding the other end like it is walking the cat

A big black dog and a small white puppy wrestling on the couch Two dogs asleep on the bed with their paws wrapped around each other

A black cat and a white kitten curled together on a bath mat A black cat and a fluffy gray cat lounging together in the sun

Three tabby cats piled together in one bed

About

Local system-tray web app that reveals, redeems, matches, and gives away your Humble Bundle keys - Steam, GOG, Humble Choice. 100% private, runs on your machine.

Topics

Resources

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages