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.
