signal-works/humble-steam-check
2
0
Fork 0
Code Issues Pull requests Projects Releases 7 Packages Wiki Activity Actions
Firefox extension that shows which Humble Bundle games are already in your Steam library
28 commits 1 branch 8 tags 4.8 MiB
  • JavaScript 74.8%
  • HTML 14.7%
  • CSS 10.5%
Find a file
Exact
Grak 1664ccc3c8 fix: YAML heredoc breaking workflow parse
2026-02-13 23:40:38 -05:00
.forgejo/workflows fix: YAML heredoc breaking workflow parse 2026-02-13 23:40:38 -05:00
icon-drafts v0.1.1: improved matching, CSP, icons, AMO prep 2026-02-08 20:54:28 -05:00
icons add cropped transparent icon for README header 2026-02-08 22:20:06 -05:00
.gitignore Remove unredacted screenshot, add to gitignore 2026-02-08 22:07:58 -05:00
background.js Initial release: Humble Steam Check v0.1.0 2026-02-08 19:16:12 -05:00
content.js Initial release: Humble Steam Check v0.1.0 2026-02-08 19:16:12 -05:00
LICENSE Initial release: Humble Steam Check v0.1.0 2026-02-08 19:16:12 -05:00
manifest.json v0.2.2: auto-generated changelogs for AMO and Forgejo releases 2026-02-13 23:34:26 -05:00
matcher.js v0.1.1: improved matching, CSP, icons, AMO prep 2026-02-08 20:54:28 -05:00
popup.css v0.2.0: extract popup CSS, add Chrome screenshot, split Firefox manifest 2026-02-13 21:18:42 -05:00
popup.html v0.2.1: fix missing popup.css in AMO build, restore CSP header 2026-02-13 23:07:30 -05:00
popup.js Initial release: Humble Steam Check v0.1.0 2026-02-08 19:16:12 -05:00
PRIVACY.md v0.1.1: improved matching, CSP, icons, AMO prep 2026-02-08 20:54:28 -05:00
README.md fix squished icon - constrain height only 2026-02-08 22:20:39 -05:00
screenshot-amo-redacted.png v0.1.1: improved matching, CSP, icons, AMO prep 2026-02-08 20:54:28 -05:00
screenshot-chrome.png v0.2.0: extract popup CSS, add Chrome screenshot, split Firefox manifest 2026-02-13 21:18:42 -05:00
styles.css Initial release: Humble Steam Check v0.1.0 2026-02-08 19:16:12 -05:00

README.md

icon Humble Steam Check

A Firefox extension that shows which games on Humble Bundle pages are already in your Steam library.

Badge example

What It Does

When you browse a Humble Bundle page, the extension marks each game with a badge:

  • ✓ Owned (green) — You own this game on Steam
  • ⊕ Base Owned (blue) — You own the base game; this is DLC for it
  • ★ Wishlisted (gold) — This game is on your Steam wishlist
  • ✗ Not Owned (red) — Not found in your Steam library

How It Works

  1. Fetches your Steam library via the Steam Web API
  2. Scans the Humble Bundle page for game titles
  3. Matches games by Steam app ID when available, fuzzy name matching as fallback
  4. Recognizes DLC and edition variants (Reloaded, GOTY, Deluxe, etc.)
  5. Caches your library for 1 hour to minimize API calls

Setup

  1. Install the extension (see Installation)
  2. Click the extension icon in your toolbar
  3. Get your Steam API key at steamcommunity.com/dev/apikey
  4. Find your Steam ID (64-bit) at steamdb.info/calculator
  5. Paste both into the popup and click Save & Sync
  6. Browse Humble Bundle — badges appear automatically!

Installation

Firefox (from source)

  1. Download the Firefox zip from the latest release or clone this repo
  2. Open about:debugging#/runtime/this-firefox
  3. Click "Load Temporary Add-on"
  4. Select manifest.json from the extracted directory

Firefox Add-ons

AMO

Install from addons.mozilla.org.

Chrome (from source)

  1. Download the Chrome zip from the latest release
  2. Unzip it
  3. Open chrome://extensions and enable Developer Mode
  4. Click "Load unpacked" and select the unzipped folder

Chrome Web Store submission is planned after AMO approval.

Important Notes

  • DLC detection is limited. Steam's API doesn't report individual DLC ownership. DLC items show "⊕ Base Owned" if you own the parent game, but you may already own the DLC too — we just can't confirm it.
  • Matching isn't perfect. Game names sometimes differ between Humble and Steam. The fuzzy matcher handles most cases, but edge cases exist.
  • Wishlist requires a public profile. If your Steam wishlist is set to private, wishlist badges won't appear.

Privacy

  • Your Steam API key is stored locally in the browser extension storage
  • The key is only sent to Steam's API — nowhere else
  • No analytics, no tracking, no external servers

Development

No build step — plain JavaScript, runs as-is.

humble-steam-check/
├── manifest.json       # WebExtension manifest v3
├── background.js       # Steam API calls, library caching
├── content.js          # Humble Bundle page scanning + badge injection
├── matcher.js          # Name matching (app ID, fuzzy, DLC/edition)
├── popup.html/js       # Settings UI
├── styles.css          # Badge styles
└── icons/              # Extension icons

Contributing

Found a bug or a game that doesn't match correctly? Open an issue on GitHub with the Humble Bundle page URL and your Steam game name.

Pull requests are welcome on GitHub. The primary repo is hosted on git.deco.sh; GitHub is a mirror for community contributions.

License

MIT