Discogs Monitor

Self-hosted Discogs marketplace monitoring tool with a modern web UI. Polls the Discogs API to detect meaningful collector events (records becoming available, price drops, supply changes) and sends Telegram notifications.

Features

• Automatic wantlist sync from Discogs
• Marketplace monitoring with configurable intervals
• Event detection: appeared, price drops, supply changes, threshold matches
• Telegram notifications for actionable events
• Per-item price targets and filters
• Modern web UI with PrimeVue 4 and dark mode
• Prometheus metrics for observability

Quick Start

# Start database
docker compose up -d

# Install and run backend
pip install -r requirements.txt
export DATABASE_URL="postgresql+asyncpg://discogs:discogs@localhost:5435/discogs"
export DATABASE_URL_SYNC="postgresql+psycopg2://discogs:discogs@localhost:5435/discogs"
alembic upgrade head
uvicorn app.main:app --reload

# Install and run frontend (separate terminal)
cd frontend && npm install && npm run dev

Open http://localhost:5173 and configure your Discogs token in Settings.

Deployment

Build and deploy to Saturn:

./scripts/build.sh

See CLAUDE.md for full architecture documentation.

License

MIT