https://github.com/rtuszik/discogsdash
Self-hosted dashboard to analyze and visualize your Discogs music collection. Features include value trends, genre distribution, and more. Built with Next.js and Docker
https://github.com/rtuszik/discogsdash
dashboards discogs discogs-api vinyl-records
Last synced: 12 months ago
JSON representation
Self-hosted dashboard to analyze and visualize your Discogs music collection. Features include value trends, genre distribution, and more. Built with Next.js and Docker
- Host: GitHub
- URL: https://github.com/rtuszik/discogsdash
- Owner: rtuszik
- License: mit
- Created: 2025-04-18T23:58:21.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-03T09:53:40.000Z (12 months ago)
- Last Synced: 2025-06-07T21:11:59.227Z (12 months ago)
- Topics: dashboards, discogs, discogs-api, vinyl-records
- Language: TypeScript
- Homepage:
- Size: 1.91 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
### Note
This project was the result of experimenting with Gemini 2.5 pro and autonomous agentic coding (Roocode).
The entire codebase was written by an LLM apart from some interventions where the LLM got stuck.
As a result of that, I do not plan on actively maintaining this project, though issues on bug reports are welcome.
# DiscogsDash - Your Personal Discogs Dashboard
DiscogsDash provides a personalized dashboard to visualize and analyze your Discogs music collection. Gain insights into your collection's value, distribution, and trends over time.
## First Look
## Features
- **Collection Overview:** See key statistics about your collection size and estimated value.
- **Value Trends:** Track the estimated market value of your collection over time.
- **Genre/Style Distribution:** Visualize the breakdown of your collection by genre and style.
- **Most Valuable Items:** Quickly identify the most valuable records in your collection based on Discogs market data.
- **Automatic Sync:** Keeps your dashboard updated with your latest Discogs collection changes (runs daily at 2am).
- **Self-Hosted:** Run DiscogsDash on your own server using Docker.
## Quick Start (Docker Compose)
This is the recommended way to run DiscogsDash.
**Prerequisites:**
- [Docker](https://docs.docker.com/get-docker/) installed.
- [Docker Compose](https://docs.docker.com/compose/install/) installed.
- A Discogs account.
**Steps:**
1. **Create `docker-compose.yml`:**
Create a file named `docker-compose.yml` on your system where you want to run the application.
2. **Copy Content:**
Copy the following content into your `docker-compose.yml` file:
```yaml
version: "3.8"
services:
discogsdash:
image: ghcr.io/rtuszik/discogsdash:latest # Use the pre-built image
container_name: discogsdash
ports:
- "3000:3000"
volumes:
- discogsdash-data:/app/.db
environment:
- DISCOGS_TOKEN=YOUR_DISCOGS_TOKEN_HERE # Replace with your actual token
- DISCOGS_USERNAME=YOUR_DISCOGS_USERNAME_HERE # Replace with your Discogs username
restart: unless-stopped
volumes:
discogsdash-data:
```
3. **Get Discogs Token & Username:**
- You need a **Discogs Personal Access Token**. Go to your Discogs [Developer Settings](https://www.discogs.com/settings/developers) and generate a new token. Copy it securely.
- You also need your **Discogs Username**.
**In order to retrieve the suggested pricing for individual collection items, you need to fill out your [Discogs Seller Settings](https://www.discogs.com/settings/seller/)**
4. **Configure:**
Open the `docker-compose.yml` file you created and replace the placeholder values:
- Replace `YOUR_DISCOGS_TOKEN_HERE` with your actual Discogs Personal Access Token.
- Replace `YOUR_DISCOGS_USERNAME_HERE` with your Discogs username.
5. **Run:**
Navigate to the directory containing your `docker-compose.yml` file in your terminal and run:
```bash
docker-compose up -d
```
This command will pull the latest `discogsdash` image from the GitHub Container Registry and start the application container in the background.
6. **Access:**
Open your web browser and navigate to `http://localhost:3000`. If you are running Docker on a remote server, replace `localhost` with your server's IP address or domain name.
**Data Persistence:**
Your collection data (SQLite database) is stored in a Docker volume named `discogsdash-data`. This ensures your data persists even if you stop, remove, or update the container.
## Tech Stack
- [Next.js](https://nextjs.org/) (React Framework)
- [TypeScript](https://www.typescriptlang.org/)
- [Tailwind CSS](https://tailwindcss.com/)
- [Recharts](https://recharts.org/) (Charting Library)
- [SQLite](https://www.sqlite.org/index.html) (Database)
- [Node-Cron](https://github.com/node-cron/node-cron) (Scheduler)
- [PM2](https://github.com/Unitech/pm2) (Process Manager within Docker)
- [Docker](https://www.docker.com/) / [Docker Compose](https://docs.docker.com/compose/)
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
---
_Disclaimer: This project uses the Discogs API but is not affiliated with, sponsored, or endorsed by Discogs._