diff --git a/docs/changelog.rst b/docs/changelog.rst index 71d894acd..25a29540a 100644 --- a/docs/changelog.rst +++ b/docs/changelog.rst @@ -4,6 +4,9 @@ Changelog 1.3.4 (in development) ---------------------- +One note for upgraders: the :doc:`/plugins/fetchart` has a new dependency, the +`requests`_ module. + New stuff: * Added a :ref:`config-cmd` command to manage your configuration. It can show @@ -38,6 +41,11 @@ Fixes: again to geigerzaehler. * Fix a crash when reading WMA files whose boolean-valued fields contain strings. Thanks to johtso. +* :doc:`/plugins/fetchart`: The plugin now sends "beets" as the User-Agent + when making scraping requests. This helps resolve some blocked requests. The + plugin now also depends on the `requests`_ Python library. + +.. _requests: http://www.python-requests.org/ 1.3.3 (February 26, 2014) diff --git a/docs/plugins/fetchart.rst b/docs/plugins/fetchart.rst index 1682ae840..fce406fdb 100644 --- a/docs/plugins/fetchart.rst +++ b/docs/plugins/fetchart.rst @@ -4,13 +4,20 @@ FetchArt Plugin The ``fetchart`` plugin retrieves album art images from various sources on the Web and stores them as image files. +To use the plugin, first enable it in your configuration (see +:ref:`using-plugins`). Then, install the `requests`_ library by typing:: + + pip install requests + +The plugin uses `requests`_ to fetch album art from the Web. + +.. _requests: http://docs.python-requests.org/en/latest/ Fetching Album Art During Import -------------------------------- -To automatically get album art for every album you import, just enable the -plugin by putting ``fetchart`` on your config file's ``plugins`` line (see -:doc:`/plugins/index`). +When the plugin is enabled, it automatically gets album art for every album +you import. By default, beets stores album art image files alongside the music files for an album in a file called ``cover.jpg``. To customize the name of this file, use