discographic
DiscoGraphic is a self-hosted Discogs companion that turns your collection into a richer workspace: faster browsing, deeper stats, safer bulk edits, filtered Excel export/import, and visual tools like cover mosaics and posters.
What is it?
What it is
A self-hosted web application for managing and visualizing a Discogs vinyl collection with features like dashboard analytics, collection browser, cover wall, and export capabilities.
Why it exists
To provide collectors with a personal, self-hosted tool for organizing their Discogs records, offering local data storage, visualizations, and collector-focused features beyond basic CRUD operations.
Who should use it
Teams building with TypeScript who want an open-source, self-hosted option.
Who should avoid it
Teams that need a fully managed SaaS with enterprise SLAs out of the box.
How it works
A quick walkthrough in plain English
How discographic works
Step 1 of 3
You interact with it
Open discographic, send a request, or connect it to your stack.
Features
Advantages
- Open source (MIT)
- Active TypeScript ecosystem
- Self-hosted deployment options
Disadvantages
- Requires operational ownership for self-hosted setups
- Community support varies by project maturity
Installation
native
pnpm install
compose
git pull docker compose up -d --build
FAQ
How do I run Discographic using Docker?
Clone the repository, navigate into the folder, and run `docker compose up -d`. Then open http://localhost:3800 in your browser.
How do I obtain and enter my Discogs personal access token?
Visit discogs.com/settings/developers, click 'Generate new token', copy the token, then in Discographic go to Settings, enter your Discogs username and the token, and run 'Sync with Discogs'.
How do I update Discographic to a newer version?
Run `git pull` to fetch the latest code, then execute `docker compose up -d --build` to rebuild and restart the containers. Your SQLite database and cached covers are preserved in Docker volumes.
How can I change the port Discographic runs on?
Edit the PORT value in your `.env` file (or modify `docker-compose.yml`) and restart the containers with `docker compose up -d`. For example, set PORT=3801 to use port 3801.
What should I do if I encounter installation errors with better-sqlite3 or sharp?
These packages require native build tools. On Linux install `build-essential` and `python3`; on macOS install Xcode command line tools. Using the Docker image avoids this issue entirely.
How do I run the temporary test instance for QA?
Start a disposable instance with `pnpm run test:instance:start -- --host 127.0.0.1 --port 3801`. It creates demo admin and user accounts. When finished, stop it with `pnpm run test:instance:stop -- --host 127.0.0.1 --port 3801`.
Featured in Videos
YouTube tutorials and walkthroughs for discographic
s5
896,635 views
Starts at 00:00
Alternatives
Similar projects ranked by category, topics, and text overlap.
