beets/docs/plugins
Tai Lee 3eb6f8e5eb Add discogs plugin, which extends the autotagger to include results from the discogs database.
This is a refactor of the plugin developed by `imenem`.

- Pass `artist`, `album` and `va_likely` to `candidates()` so that
  plugins don't have to work this out from `items` all over again.
- Pass `artist` and `title` to `item_candidates()`.
- Silence spurious `urllib3` info log lines.
- Use a proper "beets" user agent with `discogs_client`.
- Remove `abstract_search` plugin. It seems unnecessary. How many
  music databases are there? How many will beets support? How much
  common code might there be between them? We can add some abstraction
  if or when more databases are supported.
- Derive more AlbumInfo and TrackInfo properties from discogs Release
  objects, especially album ID so that beets doesn't just use the first
  release and think all subsequent releases are duplicates.
- Add basic documentation, doc strings and code comments.
- Sanitise search query. Remove non-word characters and medium info that
  might filter out good search results.
- Use artist `join` strings from discogs Release object when an album
  or track has multiple artists.
- Don't rely on discogs track position, which is unreliable. But tracks
  are in order, so we can recalculate medium and medium_index as long as
  we can extract a consistent medium across tracks from the position.
- Add "various" as a known signal to indicate various artists.
- Prevent `chroma` plugin from returning a a huge track distance for any
  track that is missing an ID (e.g. all discog tracks).
- `TrackInfo.index` should be the release index (calculated by beets),
  not the medium index (derived from discogs track position).
- Add `AlbumInfo.data_source`. It's "Unknown" by default which is shown
  in red when displaying a suggested or selected match. The built in
  auto tagger sets it to "MusicBrainz" which is shown in green. Anything
  else (e.g. "Discogs") is shown in yellow.
- Remove double spaces from album titles (bad data from Discogs).
2013-05-21 21:16:52 +10:00
..
beetsweb.png fix typo in web screenshot (closes #222) 2013-03-15 10:26:58 -07:00
bpd.rst use gst-python from stock Homebrew 2013-02-21 11:03:08 -08:00
chroma.rst chroma: fingerprint command's write from config 2013-03-11 19:19:48 -07:00
convert.rst convert auto: changelog and de-cloning (#212) 2013-03-10 13:12:56 -07:00
discogs.rst Add discogs plugin, which extends the autotagger to include results from the discogs database. 2013-05-21 21:16:52 +10:00
echonest_tempo.rst another docs typo 2013-04-15 16:47:31 -07:00
embedart.rst invert new embedart switch (#182) 2013-03-17 22:50:28 -07:00
fetchart.rst Update fetchart.rst 2013-04-28 12:31:23 +03:00
fuzzy.rst some low-level tweaks to extensible queries (#214) 2013-03-13 21:59:03 -07:00
ihate.rst document new Confit-based configuration 2012-12-20 21:56:47 -08:00
importfeeds.rst importfeeds: absolute path option (#180) 2013-03-13 01:50:09 -03:00
index.rst Add discogs plugin, which extends the autotagger to include results from the discogs database. 2013-05-21 21:16:52 +10:00
info.rst long-overdue docs for the "info" plugin 2012-11-27 19:44:46 -08:00
inline.rst Update inline plugin doc by providing an example about how to define a field depending on 'path' attribute. 2013-03-27 23:19:15 +01:00
lastgenre.rst changelog for #254 2013-04-21 20:41:01 -07:00
lyrics.rst Update lyrics.rst 2013-04-16 00:12:08 +03:00
mbcollection.rst collections broken link 2013-03-12 10:34:51 -03:00
mbsync.rst mbsync: don't write tags if import.write is off 2013-03-03 17:13:54 -08:00
missing.rst changelog, little style tweak for #272 2013-05-10 22:23:24 -07:00
mpdupdate.rst document new Confit-based configuration 2012-12-20 21:56:47 -08:00
random.rst plugin renames: fuzzy and random 2012-12-23 14:46:20 -08:00
replaygain.rst document new Confit-based configuration 2012-12-20 21:56:47 -08:00
rewrite.rst document new Confit-based configuration 2012-12-20 21:56:47 -08:00
scrub.rst Update scrub.rst 2013-03-26 11:28:17 +01:00
smartplaylist.rst smartplaylist: split query w/ shlex (fixes #256) 2013-04-21 20:55:07 -07:00
the.rst the: fix config syntax in docs 2013-03-14 18:34:55 -07:00
web.rst document new Confit-based configuration 2012-12-20 21:56:47 -08:00
writing.rst Add discogs plugin, which extends the autotagger to include results from the discogs database. 2013-05-21 21:16:52 +10:00
zero.rst document new Confit-based configuration 2012-12-20 21:56:47 -08:00