GameShelf Downloads

Personal video game collection manager — Windows MSI and macOS PKG installers.

Installing on Windows

Run the downloaded .msi.
If SmartScreen blocks it ("Windows protected your PC"), click More info, then Run anyway.
Follow the installer.

Installing on macOS

Open the downloaded .pkg. It will say it's blocked — click Done (not "Move to Trash").
Open System Settings → Privacy & Security.
Scroll to the bottom of the Security section — you'll see "...was blocked to protect your Mac."
Click Open Anyway, then Open Anyway again in the popup, and enter your password.

1.7.0 — Prefer Local Artwork Cache Over Remote IGDB URLs Across CLI, WPF, and macOS (issue #7)

2026-08-08

Added a shared ArtworkPathResolver (GameShelfServices) so the CLI, WPF, and the macOS app (via GameShelfApi) all consistently prefer already-cached/custom local artwork over remote IGDB CDN URLs once a game or platform is on the shelf, falling back to the CDN only when nothing's cached yet (issue #7)
GameShelfApi's POST /api/shelf/POST /api/platforms now cache cover art/platform logos to disk on add (previously only the CLI cached covers, and only WPF cached logos), and its DTO mappers resolve local files the same way — no macOS client changes were needed, since it already consumed file:// URLs for custom artwork
Added shelf games artwork recache --id and shelf platforms logo recache --id CLI commands to force a fresh IGDB download when a cached file is missing or corrupted, and taught shelf platforms add to cache the platform logo to disk (previously only cover art was cached on add)
Fixed the CLI never reading the configured GameShelf:ArtworkCacheDir at startup, silently caching/resolving artwork against the default ~/Library/Application Support/GameShelf/artwork instead of the user's configured directory
Fixed shelf platforms refresh silently discarding a platform's version-specific logo in favor of the parent IGDB platform's logo, which broke local artwork resolution for any platform originally added under a specific hardware version

Download for Windows (.msi) Download for macOS (.pkg)

SHA-256 (MSI): fc9672c242394f9cc45658c94786aee1d0daf631f9c06f36ab066b28e27f885b
SHA-256 (PKG): 731ce22db17a1b71f16443317e97d7a6b61310cfc26481484f36461762d7eec9

1.6.1 — Fix Twitch Sign-In for All Users via Client Credentials Grant (issue #117)

2026-08-08

Replaced the broken Authorization Code + PKCE sign-in flow (a single hardcoded Client ID shared by every install, mismatched against each user's own locally-configured Client Secret) with Twitch's Client Credentials Grant — a direct server-to-server credential check with no browser, redirect URI, or "Sign In"/"Sign Out" concept, fixing sign-in for every user except the original developer (issue #117)
Added a Client ID field alongside the existing Client Secret field across the CLI (config igdb-client-id, replacing auth login/auth logout), WPF, and macOS Settings/first-run screens, with the resulting pair validated against Twitch immediately on save instead of only failing later at search time
Rewrote the "Setting Up IGDB API Credentials" Help doc with a full Twitch app registration and two-factor authentication walkthrough plus real screenshots, and removed the now-obsolete "Signing In (OAuth Login Flow)" topic

Download for Windows (.msi) Download for macOS (.pkg)

SHA-256 (MSI): d3bedec8200bf3f424132f3de3dc4d1924b392cdb5e47ee5f6b1ceb87831a407
SHA-256 (PKG): cbbb6f09c76dc903fabb432b3ed0c89cb41dec0941f14c66206930792ae2fb91

1.6.0 — Complete macOS App Feature Parity: Filtering, Full Field Editing, and Installer (issue #37)

2026-08-03

Added a full filter panel to the macOS app (Genre/Platform/Notes/Ownership/Loan Status/Play Status/Media Type/Release Year/Rating), matching WPF's filter fields, with Apply/Clear and a "Filter Active" indicator; added client-side Sort (9 fields) and Group By (All Games/Platform/Genre) toolbar controls plus View-menu equivalents, and made List view's column headers clickable to sort, mirroring WPF
Expanded the macOS detail pane from a handful of editable fields to full parity with WPF's 19 revertable fields per game/platform, organized into the same collapsible sections (Credits, Ratings, Classification, Style & Modes, Owner Details, Storyline & Related Titles, Media for games; Classification, Owner Details, Hardware Specs for platforms), and added editable "Owned On" platform and a Summary field to the always-visible section
Added a first-run onboarding sheet prompting for an IGDB Client Secret on first macOS launch, with a help link into the in-app Help viewer
Added a genuine macOS Installer .pkg wizard (Introduction/Destination Select/Installation Type/Install/Summary) as an alternative to the drag-to-Applications .dmg, bundling both the GUI app and a gameshelf CLI binary installed to /usr/local/bin
Fixed several install-time bugs found via real-device testing on a genuinely fresh machine: the bridge and CLI failing to bootstrap a shared config file when none exists yet anywhere on the machine (previously silently swallowed into a generic "did not become ready in time"/silent CLI exit); the embedded bridge and CLI binaries only ever being published for whichever architecture built them rather than a universal (x86_64 + arm64) binary; a default database path resolving inside the installed, read-only app bundle instead of the shared, always-writable app-data directory; and Help content (Markdown/CSS/icons) never actually being copied into the packaged app bundle

Download for Windows (.msi) Download for macOS (.pkg)

SHA-256 (MSI): b40901b0fe6dbe07f3e68dec3d2c2aaf9fc8d7a3e1bdcc6b68a1e4555acf5270
SHA-256 (PKG): f161897f3fe13c7b4f56c7412b020d1726185b2e0e985ee0341d9543b3393441