Backup_Repos/beets
1
0
Fork 0
mirror of https://github.com/beetbox/beets.git synced 2026-02-22 07:14:24 +01:00
Code Issues Projects Releases Wiki Activity

fetchart: document 'cautious' and 'cover_names' options

Browse source
This commit is contained in:
Fabrice Laporte 2013-04-27 12:54:56 +02:00
parent ac14b7f2fb
commit 5aab7334e3
1 changed files with 16 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

24
docs/plugins/fetchart.rst
View file

@ -67,21 +67,29 @@ Currently, this plugin searches for art in the local filesystem as well as on
the Cover Art Archive, Amazon, and AlbumArt.org (in that order).
When looking for local album art, beets checks for image files located in the
same folder as the music files you're importing. If you have an image file
called "cover," "front," "art," "album," for "folder" alongside your music,
beets will treat it as album art and skip searching any online databases.
same folder as the music files you're importing. beets prefers to use an image
file which name contains one of the accepted keywords ("cover", "front", "art", "album" or "folder").
In the absence of well-known names, any image file in the
same folder as your music files is ignored unless ``cautious`` option is set to false.
In case you're not satisfied with the default keywords list it can be changed
via the `cover_names` option ::
When you choose to apply changes during an import, beets searches all sources
for album art. For "as-is" imports (and non-autotagged imports using the ``-A``
flag), beets only looks for art on the local filesystem.
fetchart:
cautious: false
cover_names: front back
By default, remote (Web) art sources are only queried if no local art is found
in the filesystem. To query remote sources every time, set the
``remote_priority`` configuration option to false.
``remote_priority`` configuration option to true, which will cause beets to
prefer remote cover art over any local image files.
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
``-A`` flag), beets only looks for art on the local filesystem.
Embedding Album Art
-------------------
This plugin fetches album art but does not embed images into files' tags. To do
that, use the :doc:`/plugins/embedart`. (You'll want to have both plugins
enabled.)
enabled.)