Discogs Plugin

The discogs plugin extends the autotagger’s search capabilities to include matches from the Discogs database.


To use the discogs plugin, first enable it in your configuration (see Using Plugins). Then, install the python3-discogs-client library by typing:

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.

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.

OAuth Authorization

The first time you run the import command after enabling the plugin, it will ask you to authorize with Discogs by visiting the site in a browser. Subsequent runs will not require re-authorization.

Authentication via Personal Access Token

As an alternative to OAuth, you can get a token from Discogs and add it to your configuration. 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 Generate new token button, and place the generated token in your configuration, as the user_token config option in the discogs section.


This plugin can be configured like other metadata source plugins as described in Using Metadata Source Plugins.

There is one additional option in the discogs: section, index_tracks. 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:

    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

whereas with index_tracks disabled you’d get:

No.1: Sinfony
No.22: Chorus- Behold The Lamb Of God

This option is useful when importing classical music.


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.json by 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.