diff --git a/docs/plugins/fetchart.rst b/docs/plugins/fetchart.rst index 2ea9211f9..cef2d4b83 100644 --- a/docs/plugins/fetchart.rst +++ b/docs/plugins/fetchart.rst @@ -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.) \ No newline at end of file