MusicBrainz Enricher

A Java application to enrich MusicBrainz data from linked sources.

About

Queries the MusicBrainz API and fetches data from linked sources like Discogs or Spotify.

Requirements

• Java Runtime Environment 21
• Docker

Supported Relationship Sources

• Releases (mode = release)
  • Apple Music / iTunes
  • Bandcamp
  • Discogs
  • Junodownload
  • Spotify
• Release Groups (mode = release-group)
  • Allmusic
  • Discogs
  • Wikidata

Configuration

This application uses Spring Boot, which allows for easy handling of configurations. See the Spring Boot documentation for details.

• musicbrainz-enricher.host (Either "test.musicbrainz.org" or "musicbrainz.org")
• Credentials
  • Musicbrainz
    • musicbrainz-enricher.musicbrainz.username
    • musicbrainz-enricher.musicbrainz.password
  • Discogs API(can be left empty to use (slower) unauthenticated discogs API access)
    • musicbrainz-enricher.discogs.token
  • Spotify API (can be left empty to disable spotify API access)
    • musicbrainz-enricher.spotify.client-id
    • musicbrainz-enricher.spotify.client-secret

Usage

Before starting, set up a copy of the MusicBrainz database using https://github.com/metabrainz/musicbrainz-docker locally with the database port open.

This tool can run in auto-query or single mode. Auto-query mode will enrich every entity from the MusicBrainz database. Single mode takes a MusicBrainz MBID and will enrich the matching entity.

Auto-query mode: java -jar musicbrainz-enricher*.jar release.

Single mode: java -jar musicbrainz-enricher*.jar release 'MBID'.

History Storage

The application will remember entities checked already and will not re-check them. To reset this, truncate the *_history_entry tables in the schema musicbrainz_enricher.