# discogs_player v0.2.3 ## Summary - Release type: `stable` - Tag: `v0.2.3` - Date: `2026-06-28` - Scope: first-run / supportability polish (in-app "Report a problem", clearer web setup errors, quieter snap first launch) plus internal quality hardening (CI lint/type/test gates, shared coercion utilities, webapp unit tests). ## Who This Is For Discogs Spinner is for record collectors who already use Discogs and want a faster daily utility than browser tabs. Bring a Discogs personal access token, sync your collection once, then browse your shelf, spin a random pick, inspect market value, and review wantlist context from one local app. ## Highlights - Adds an in-app **"Report a problem"** path — a header-menu entry in the GTK desktop app and a persistent footer link in the web/desktop app — so reporting an issue no longer requires hunting for the repository. - Makes web setup errors clearer by distinguishing token/auth failures from network failures, matching the desktop setup wizard's wording. - Quiets repeated GLib schema warnings on first snap launch by precompiling the bundled GSettings schemas. - Hardens the launcher: a broken or partial PyGObject install now shows the install-dependencies guidance instead of a raw traceback. - Internal quality: CI now enforces lint, type checking, the full Python test suite, and webapp lint/type/tests on every change; duplicated coercion helpers were consolidated into shared modules; and the webapp gained its first unit-test suite (vitest). ## Packaging And Distribution - Linux Snap Store listing: [Spinner for Discogs on Snapcraft](https://snapcraft.io/spinner-for-discogs) - Windows package manager: `winget install ErichDonahue.SpinnerforDiscogs` - Artifacts published by `Installer Build`: - Windows `.msi` - Windows NSIS `.exe` - macOS `.dmg` - Linux Tauri `.deb` - Linux `.AppImage` - Linux GTK desktop `.deb` - Checksum manifest: `CHECKSUMS-INSTALLERS.txt` - Installer manifest: `INSTALLER-MANIFEST.txt` - Build workflow: `Installer Build` ## Direct Download Links - Linux Snap Store: [install Spinner for Discogs from Snapcraft](https://snapcraft.io/spinner-for-discogs), or run `sudo snap install spinner-for-discogs` if `snapd` is already set up. - Windows installer (guided): [Discogs Spinner_0.2.3_x64-setup.exe](https://github.com/edonahue/Discogs_Spinner/releases/download/v0.2.3/Discogs.Spinner_0.2.3_x64-setup.exe) - Windows installer (MSI): [Discogs Spinner_0.2.3_x64_en-US.msi](https://github.com/edonahue/Discogs_Spinner/releases/download/v0.2.3/Discogs.Spinner_0.2.3_x64_en-US.msi) - Linux desktop installer (GTK): [discogs-spinner-gtk4_0.2.3_amd64.deb](https://github.com/edonahue/Discogs_Spinner/releases/download/v0.2.3/discogs-spinner-gtk4_0.2.3_amd64.deb) - Linux desktop installer (Tauri): [discogs-spinner-tauri_0.2.3_amd64.deb](https://github.com/edonahue/Discogs_Spinner/releases/download/v0.2.3/discogs-spinner-tauri_0.2.3_amd64.deb) - Linux portable installer: [Discogs Spinner_0.2.3_amd64.AppImage](https://github.com/edonahue/Discogs_Spinner/releases/download/v0.2.3/Discogs.Spinner_0.2.3_amd64.AppImage) - macOS installer (Apple Silicon): [Discogs Spinner_0.2.3_aarch64.dmg](https://github.com/edonahue/Discogs_Spinner/releases/download/v0.2.3/Discogs.Spinner_0.2.3_aarch64.dmg) - macOS installer (Intel): [Discogs Spinner_0.2.3_x64.dmg](https://github.com/edonahue/Discogs_Spinner/releases/download/v0.2.3/Discogs.Spinner_0.2.3_x64.dmg) - Checksums: [CHECKSUMS-INSTALLERS.txt](https://github.com/edonahue/Discogs_Spinner/releases/download/v0.2.3/CHECKSUMS-INSTALLERS.txt) - Manifest: [INSTALLER-MANIFEST.txt](https://github.com/edonahue/Discogs_Spinner/releases/download/v0.2.3/INSTALLER-MANIFEST.txt) ## Install And Setup - Windows quickstart: [docs/quickstart_windows.md](../quickstart_windows.md) - Debian quickstart: [docs/quickstart_debian.md](../quickstart_debian.md) - macOS quickstart: [docs/quickstart_macos.md](../quickstart_macos.md) - Discogs token setup: [docs/token_setup.md](../token_setup.md) ## First 10 Minutes 1. Install from the Snap Store on Linux, or download the installer for your OS. 2. Launch Discogs Spinner. 3. Paste your Discogs personal access token into the setup wizard. 4. Run the first sync. 5. Use Browse or Spin to choose a record, then open Value or Wantlist for context. ## Validation Evidence - Installer workflow: published the expected cross-platform assets via `Installer Build`. - Release asset verification: `CHECKSUMS-INSTALLERS.txt` and `INSTALLER-MANIFEST.txt` published with the release assets. - Linux metadata validation: pass (`venv/bin/python scripts/validate_linux_packaging_metadata.py`). - CI quality gates: lint (ruff + mypy), full Python test suite, and webapp lint/type/tests all green on the release commit. ## Known Limitations - macOS builds are currently unsigned and may require a one-time Gatekeeper quarantine removal. - Windows builds may show SmartScreen warnings until signing is added. - Optional playback providers remain optional; Discogs collection, value, wantlist, and discovery workflows work without Spotify configured. - Linux users should start with the Snap Store listing. The GTK `.deb`, Tauri `.deb`, and AppImage remain alternate direct-download paths. ## Upgrade / Migration Notes - Breaking changes: none. - Existing local data and config paths are unchanged. - Existing cached cover art and synced collection data remain compatible. ## Reporting Issues When filing issues, attach: - `dplayer diagnostics --json` - reproduction steps - OS and installer path details Issue template areas: - [install failure](https://github.com/edonahue/Discogs_Spinner/issues/new?template=install_failure.yml) - [auth/setup failure](https://github.com/edonahue/Discogs_Spinner/issues/new?template=auth_failure.yml) - [playback failure](https://github.com/edonahue/Discogs_Spinner/issues/new?template=playback_failure.yml)