Discogs Collection Explorer

Interactive terminal tool for digging through your Discogs vinyl collection.

Because scrolling through Discogs web interface to find that one pressing from 1973 gets old.

What It Does

• Collection Stats - See your collection broken down by artist, label, genre, decade, format
• Search - Find releases by artist or title
• Duplicate Finder - Spot different pressings of the same album
• Wantlist - Track what you're hunting for, add and remove want list items

Built for people with too many records and not enough shelf space.

Setup

1. Get a Discogs API Token

1. Go to https://www.discogs.com/settings/developers
2. Scroll to "Personal Access Tokens"
3. Click "Generate new token"
4. Give it a name like "Collection Explorer"
5. Copy the token

2. Install

git clone https://github.com/willc/discogs-collection-explorer.git
cd discogs-collection-explorer
pip install -r requirements.txt

3. Configure

Create a .env file with your token:

cp .env.example .env
nano .env  # or use your favorite editor

Paste your token:

DISCOGS_TOKEN=your_actual_token_here

4. Run

python -m discogs_explorer.cli

Or install it properly:

pip install -e .
discogs-explorer

Usage

The tool is interactive - just follow the menu:

╔════════════════════════════════════════╗
║  Discogs Collection Explorer          ║
╚════════════════════════════════════════╝

What do you want to do?

  1 - View collection statistics
  2 - Search collection
  3 - Find duplicates
  4 - View wantlist
  q - Quit

Pro tip: The first time you run stats, it'll take a minute to fetch your whole collection. Grab coffee.

Requirements

• Python 3.7+
• A Discogs account with some records in it
• Patience (large collections take time to analyze)

License

MIT - dig through your vinyl however you want

Credits

Made by @willc who has way too many records and needed a better way to explore them