Backup_Repos/beets
1
0
Fork 0
mirror of https://github.com/beetbox/beets.git synced 2025-12-08 01:23:09 +01:00
Code Issues Projects Releases Wiki Activity

Advanced fetchart source config: documentation

Browse source
This commit is contained in:
wisp3rwind 2018-02-24 10:55:29 +01:00
parent dee2885457
commit db85c28c7f
1 changed files with 23 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

24
docs/plugins/fetchart.rst
View file

@ -54,7 +54,8 @@ file. The available options are:
matches at the cost of some speed. They are searched in the given order, matches at the cost of some speed. They are searched in the given order,
thus in the default config, no remote (Web) art source are queried if thus in the default config, no remote (Web) art source are queried if
local art is found in the filesystem. To use a local image as fallback, local art is found in the filesystem. To use a local image as fallback,
move it to the end of the list. move it to the end of the list. For even more fine-grained control over
the search order, see the section on :ref:`album-art-sources` below.
- **google_key**: Your Google API key (to enable the Google Custom Search - **google_key**: Your Google API key (to enable the Google Custom Search
backend). backend).
Default: None. Default: None.
@ -135,6 +136,8 @@ environment variable so that ImageMagick comes first or use Pillow instead.
.. _Pillow: https://github.com/python-pillow/Pillow .. _Pillow: https://github.com/python-pillow/Pillow
.. _ImageMagick: http://www.imagemagick.org/ .. _ImageMagick: http://www.imagemagick.org/
.. _album-art-sources:
Album Art Sources Album Art Sources
----------------- -----------------
@ -150,6 +153,25 @@ file whose name contains "cover", "front", "art", "album" or "folder", but in
the absence of well-known names, it will use any image file in the same folder the absence of well-known names, it will use any image file in the same folder
as your music files. as your music files.
For some of the art sources, the backend service can match artwork by various
criteria. If you want finer control over the search order in such cases, the
following alternative syntax for the ``sources`` option can be used::
fetchart:
sources:
- filesystem
- coverart: release
- itunes
- coverart: releasegroup
- '*'
where listing a source without matching criteria will default to trying all
available strategies. Entries of the forms ``coverart: release releasegroup``
and ``coverart: *`` are also valid.
Currently, the ``coverart`` source is the only backend to support several
such values, namely ``release`` and ``releasegroup``, which refer to the
respective MusicBrainz IDs.
When you choose to apply changes during an import, beets will search for art as When you choose to apply changes during an import, beets will search for art as
described above. For "as-is" imports (and non-autotagged imports using the described above. For "as-is" imports (and non-autotagged imports using the
``-A`` flag), beets only looks for art on the local filesystem. ``-A`` flag), beets only looks for art on the local filesystem.