From 8861d7019b19080d705459fb082f38db7071cf23 Mon Sep 17 00:00:00 2001 From: Dale Sedivec Date: Wed, 24 Apr 2013 01:03:49 -0500 Subject: [PATCH] Clarify fetchart docs, and a couple corrections Reading the fetchart docs it was not clear to me that it would use _any_ image file found alongside your music files, even if the image file did not have one of the five privileged names (cover, front, art, album, folder). I humbly propose these edits to the docs in an attempt to make it more clear that, by default, any local image file will be used. I also corrected '"album," _for_ "folder"' to '"album," _or_ "folder"', and from reading the code I'm pretty sure that remote_priority needs to be true, not false, in order to prefer remote sources. --- docs/plugins/fetchart.rst | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/docs/plugins/fetchart.rst b/docs/plugins/fetchart.rst index 2ea9211f9..dcb88bcc3 100644 --- a/docs/plugins/fetchart.rst +++ b/docs/plugins/fetchart.rst @@ -67,17 +67,19 @@ 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. - -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. +same folder as the music files you're importing. beets prefers to use an image +file named "cover," "front," "art," "album," or "folder," but in the absence of +those well-known names it will use any image file in the same folder as your +music files. 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 -------------------