Discogs Price Tracker

A TypeScript CLI application that tracks the prices of your Discogs collection over time, helping you identify records that are increasing in value.

Features

• Sync your entire Discogs collection (all folders) and wantlist
• Track marketplace prices and wants count over time
• Identify records with increasing values and high demand
• Analyse optimal records to sell based on demand and price trends
• View price history and collection statistics
• SQLite database for time series data storage
• Multi-threaded sync for fast price updates

Installation

npm install
npm run build
npm link  # Makes 'discogs-tracker' available globally

Usage

1. Configure credentials

discogs-tracker config

You'll need:

• Your Discogs username
• A personal access token (get one from https://www.discogs.com/settings/developers)

2. Sync your collection

discogs-tracker sync                    # Sync with default settings
discogs-tracker sync -t 16              # Use 16 threads for faster sync
discogs-tracker sync -b 50              # Process 50 items per batch
discogs-tracker sync --force            # Force update all prices

This fetches your collection, wantlist, and current marketplace prices. The multi-threaded sync is much faster for large collections.

3. View collection value

# Show total collection value and statistics
discogs-tracker value

# Show value breakdown by format (Vinyl, CD, etc.)
discogs-tracker value -f

# Show top 20 most valuable records
discogs-tracker value -t 20

4. View price trends

# Show records increasing in value (default: >5% change)
discogs-tracker trends

# Show records with >10% increase
discogs-tracker trends -m 10

# Show all price changes (including decreases)
discogs-tracker trends --all

5. Demand analysis

# Show high-demand records and optimal sell candidates
discogs-tracker demand

# Show records with minimum 100 wants
discogs-tracker demand -w 100

# Show only high-demand analysis
discogs-tracker demand -t demand

# Show only sell candidates
discogs-tracker demand -t sell

6. Other commands

# List all records in your collection
discogs-tracker list

# Search for specific records
discogs-tracker list -s "Beatles"

# View price history for a specific release
discogs-tracker history 123456

# Check database migration status
discogs-tracker migrate -s

Development

Running Tests

npm test                    # Run all tests
npm run test:watch          # Run tests in watch mode
npm run test:coverage       # Run tests with coverage report
npm run test:ui             # Run tests with UI

Test Coverage

The project includes comprehensive unit and integration tests covering:

• Database operations: CRUD operations, migrations, price analysis
• Discogs API service: Authentication, data fetching, error handling
• Worker pool: Multi-threading, task distribution, error recovery
• Configuration management: Credential storage, validation
• Utility functions: Formatting, date handling
• Integration workflows: End-to-end sync processes

Building

npm run build               # Build TypeScript
npm run watch               # Watch mode for development
npm run dev                 # Run without building (uses tsx)

How it works

1. The app fetches your entire collection (all folders) and wantlist from Discogs
2. For each release, it finds the lowest marketplace price and wants count
3. Data is stored in a local SQLite database with timestamps
4. Running sync regularly builds up price and demand history
5. Analysis commands identify:
   • Records increasing in value
   • Records with high demand (many people want them)
   • Optimal sell candidates based on demand score (wants/price ratio) and trends

Architecture

Multi-Threading

• Worker pool system for parallel API calls
• Configurable thread count (default 8, up to 16+)
• Rate limiting to respect Discogs API limits
• Exponential backoff for failed requests

Database Schema

• Automatic migrations for schema updates
• Time series data for price tracking
• Collection folder support for organisation
• Wantlist integration for demand analysis

Performance

• 8x faster sync with multi-threading
• Smart caching to avoid redundant API calls
• Batch processing for large collections
• Memory efficient SQLite storage

Data storage

• Configuration: Stored in your system's config directory:
  • Linux/macOS: ~/.config/discogs-tracker/
  • Windows: %APPDATA%/discogs-tracker/
• Price database: Stored in data/prices.db (relative to project directory)
• Automatic backups: Created during database migrations in data/ directory

Contributing

1. Fork the repository
2. Create a feature branch
3. Add tests for new functionality
4. Ensure all tests pass: npm test
5. Submit a pull request

License

MIT License - see LICENSE file for details