discogs plugin extends the autotagger’s search capabilities to
include matches from the Discogs database.
pip install python3-discogs-client
You will also need to register for a Discogs account, and provide authentication credentials via a personal access token or an OAuth2 authorization.
Matches from Discogs will now show up during import alongside matches from MusicBrainz. The search terms sent to the Discogs API are based on the artist and album tags of your tracks. If those are empty no query will be issued.
If you have a Discogs ID for an album you want to tag, you can also enter it at the “enter Id” prompt in the importer.
Authentication via Personal Access Token¶
As an alternative to OAuth, you can get a token from Discogs and add it to
To get a personal access token (called a “user token” in the python3-discogs-client
documentation), login to Discogs, and visit the
Developer settings page. Press the
token button, and place the generated token in your configuration, as the
user_token config option in the
This plugin can be configured like other metadata source plugins as described in Using Metadata Source Plugins.
There is one additional option in the
Index tracks (see the Discogs guidelines),
along with headers, mark divisions between distinct works on the same release
or within works. When
index_tracks is enabled:
discogs: index_tracks: yes
beets will incorporate the names of the divisions containing each track into the imported track’s title. For example, importing this album would result in track names like:
Messiah, Part I: No.1: Sinfony Messiah, Part II: No.22: Chorus- Behold The Lamb Of God Athalia, Act I, Scene I: Sinfonia
index_tracks disabled you’d get:
No.1: Sinfony No.22: Chorus- Behold The Lamb Of God Sinfonia
This option is useful when importing classical music.
Other configurations available under
- append_style_genre: Appends the Discogs style (if found) to the genre tag. This can be useful if you want more granular genres to categorize your music.
For example, a release in Discogs might have a genre of “Electronic” and a style of “Techno”: enabling this setting would set the genre to be “Electronic, Techno” (assuming default separator of
", ") instead of just “Electronic”. Default:
- separator: How to join multiple genre and style values from Discogs into a string.
Several issues have been encountered with the Discogs API. If you have one, please start by searching for a similar issue on the repo.
Here are two things you can try:
- Try deleting the token file (
~/.config/beets/discogs_token.jsonby default) to force re-authorization.
- Make sure that your system clock is accurate. The Discogs servers can reject your request if your clock is too out of sync.