A Java application to enrich MusicBrainz data from linked sources.
Queries the MusicBrainz API and fetches data from linked sources like Discogs or Spotify.
- Java Runtime Environment 21
- Docker
- Releases (mode =
release
)- Apple Music / iTunes
- Bandcamp
- Discogs
- Junodownload
- Spotify
- Release Groups (mode =
release-group
)- Allmusic
- Discogs
- Wikidata
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
- Musicbrainz
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'
.
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
.