Discogs Plugin¶
The discogs
plugin extends the autotagger’s search capabilities to
include matches from the Discogs database.
Installation¶
To use the discogs
plugin, first enable it in your configuration (see
Using Plugins). Then, install the discogs-client library by typing:
pip install 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 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.
Troubleshooting¶
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.