Discogs Integration

Automatically fetch artist and album artwork from the Discogs database.

What It Does

When enabled, Black Candy Store uses the Discogs API to find and download artwork for your albums and artists. This means you get rich cover art and artist images even if your music files don't have embedded artwork.

Artwork is fetched during media scanning — when new albums or artists are indexed, the server looks them up on Discogs and pulls matching images.

Getting a Discogs Token

  1. Go to discogs.com and create an account (or log in)
  2. Navigate to SettingsDevelopers (or go directly to discogs.com/settings/developers)
  3. Click Generate new token
  4. Copy the token — it's a long alphanumeric string

Discogs personal access tokens are free and don't require creating an OAuth app. The rate limit is 60 requests per minute, which is plenty for scanning.

Setting Up in Black Candy Store

  1. Log in as an admin user
  2. Click Settings in the sidebar navigation (gear icon)
  3. Scroll down to the Integration section
  4. Paste your Discogs token into the Discogs token field
  5. Click Save

That's it. The next time you scan your library, Black Candy Store will look up artwork on Discogs for any albums or artists that don't already have images.

How Matching Works

The server searches Discogs by album title and artist name. Matching is best-effort — it works well for commercially released music but may not find results for:

You can always upload custom artwork manually through the web interface if Discogs doesn't find a match.

Rate Limits

Discogs allows 60 authenticated requests per minute. If you're scanning a very large library for the first time, the process will automatically throttle to stay within limits. This means initial artwork fetching for a large collection might take some time, but subsequent scans only look up new additions.

Removing the Token

To disable Discogs integration, clear the token field in Settings and click Save. Existing artwork that was already downloaded will remain — only future lookups are affected.