Pick what to play, rediscover your shelves, and understand what your records are worth.
Discogs Spinner is a local-first desktop companion for vinyl collectors who already keep a Discogs collection. Install it, connect your Discogs personal access token, sync once, then browse your shelf, spin a random record, inspect market value, and keep wantlist context close without living in browser tabs.
Part of my Open Workbench; featured on erichdonahue.com/music.
Playback note: Discogs Spinner does not stream audio. It controls playback in external apps (e.g. Spotify Connect).
Discogs token required: You need a Discogs account and a personal access token so the app can read your collection, wantlist, and market data. Get the token setup steps →
Release note: The download links below point to the latest stable public release,
v0.2.1. Themainbranch may describe unreleased improvements that will ship after the next packaging pass.
Your Discogs collection probably lives in a browser tab today. You scroll when you cannot decide what to play, check market prices in another tab, and open yet another app when you finally choose. Discogs Spinner turns that daily collector loop into one focused utility: your collection, random picks, wantlist context, and market value in one local app. No subscription. No extra cloud account. Just your records on your machine.
Use it when you want to:
- choose tonight's record without scrolling forever
- find neglected albums, hidden gems, and stale market values
- see whether a wantlist item is worth chasing
- keep a quick local dashboard of collection health and value
- hand a selected release off to Spotify or YouTube Music when optional playback is configured
- Browse & Spin — gallery, carousel, or text-menu view with a one-click random pick that honors your current filters
- Collection Summary — LP/45 counts, median collection value, and most-recently-added context on the browse surface
- Market Value Tracking — price history, snapshot diffs, value movers, a refresh priority queue (
dplayer value queue), and a market value dashboard - Value Workspace — search synced releases, inspect selected-release value detail, and jump from Browse to Value with the selected release carried over
- Wantlist Management — priority signals, opportunity comparisons, and filtered views
- Tracklist at a Glance — cached track lists in the detail panel and in a quick-view modal, no round trip to Discogs
- Playback Control (optional) — Spotify Connect or YouTube Music (native album search with browser handoff)
- Setup Wizard — first-run token configuration, no terminal required
- CLI-first & SSH-ready — every workflow available from
dplayerin a terminal
- Analytics & Recent pages (web) — collection trends and a recently-added view
- Hidden Gems — value + scarcity signals for owned releases that may deserve attention
- Cache management —
dplayer cache stats | prune | warmto inspect, trim, or pre-fetch cover art - Share & export —
dplayer share collection | valueemits CSV or Markdown for pasting into notes, issues, or spreadsheets - Match audit & review queue —
dplayer reviewworkflow for approving Spotify / YouTube Music album matches in bulk - Collection Health scoring —
dplayer healthto spot mapping gaps and staleness
Before launching, have this ready:
- a Discogs account with a collection or wantlist
- a Discogs personal access token from Settings → Developers
- optional Spotify credentials only if you want playback control
Your first run should look like this:
- Install the app for your OS.
- Open Discogs Spinner and paste your Discogs token into the setup wizard.
- Start the first sync.
- Browse your collection, hit Spin, and inspect the selected record.
- Check Value, Wantlist, or Insights when you want market and collection context.
After setup, the daily flow should stay simple:
- Sync occasionally (
dplayer sync) to keep collection + wantlist fresh - Pick something quickly (
dplayer spinor native/web browse) - Check context (value, hidden gems, health, wantlist pressure)
- Play or open (
dplayer play --last-spin --open) if optional playback is connected
If you prefer a compact terminal briefing, run:
dplayer insightsSpotify (and other playback providers) are optional.
Without Spotify configured, you still get:
- full Discogs collection + wantlist sync
- browse, filters, and spin workflows
- value dashboard, hidden gems, and health scoring
- local cache and export/share tooling
- provider readiness + setup diagnostics for optional integrations
You only lose direct playback control handoff until an optional provider is connected.
| Mode | Launch | Best for |
|---|---|---|
| Native app | Installed desktop app | Windows, macOS, Linux desktop users |
| CLI | dplayer |
Terminal users, SSH, scripting |
| Web App | dplayer-api then open browser |
Browser-first setups on any OS |
Browse gallery · Album detail after spin
Collection Value Dashboard · Wantlist gallery
Setup Wizard — first-run token configuration
These installers are meant to get a collector to value quickly: install, paste a Discogs token, sync, browse, and spin.
- Open the latest stable release page
- Windows: use the guided installer first: Discogs Spinner_0.2.1_x64-setup.exe. Use Discogs Spinner_0.2.1_x64_en-US.msi only if you specifically want MSI deployment tooling.
- macOS: download the
.dmgthat matches your Mac, then drag Discogs Spinner into/Applications: Apple Silicon or Intel. - Debian/Ubuntu: start with the GTK desktop build: discogs-spinner-gtk4_0.2.1_amd64.deb.
- Linux portable fallback: Discogs Spinner_0.2.1_amd64.AppImage.
- Linux alternate desktop build: discogs-spinner-tauri_0.2.1_amd64.deb.
- Verify downloads with CHECKSUMS-INSTALLERS.txt.
What first launch should feel like:
- The app opens into a simple setup wizard if no Discogs token is configured yet.
- You paste your token once, start your first sync, and wait for the collection view to load.
- A good first run ends with your records visible, a working Spin button, and clear next steps for optional playback.
Quick install notes:
- Windows may show a SmartScreen warning until code signing is added.
- macOS builds are currently unsigned and may require a one-time Gatekeeper approval step.
- Debian/Ubuntu users should start with the GTK
.deb; the Tauri.debis an alternate desktop build, and the AppImage is the portable fallback.
Sending this to a friend?
- Use the Friend Trial Guide for the shortest install/setup checklist.
- Use the Friend Trial Checklist for a fast pass/fail validation run.
- Ask them to report install, setup, or playback friction with OS, installer used, exact warning text, and a screenshot if possible.
- GitHub issue templates: install, auth/setup, playback
Need the terminal-first path instead?
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
export DISCOGS_TOKEN="your_discogs_personal_token"
dplayer setup
dplayer sync
dplayer spin
dplayer play --openNeed a token? Get your Discogs personal access token →
Optional Spotify addon:
pip install -e ".[spotify]"
dplayer auth spotify-doctorNeed Spotify credentials? Set up Spotify API access →
New here? Start with the native installer quickstart for your OS. Use the web quickstart only if you want a browser-based fallback instead of the installed app.
- Not sure where to start? → START HERE
- Windows Quickstart
- Debian Quickstart
- macOS Quickstart
- Web App Quickstart
- Token Setup (Discogs + Spotify)
- Friend Trial Guide
- Friend Trial Checklist
- Windows + WSL2 GUI Quickstart
Developer Docs
Repository name:
Discogs_Spinner| Package/CLI:discogs_player/dplayer