mirror of
https://github.com/beetbox/beets.git
synced 2026-01-05 23:43:31 +01:00
7f2aa44ac6
artresizer.py instances an ArtResizer object that uses internally the PIL; ImageMagick or a web proxy service to perform the resizing operations. Because embedart works on input images located on filesystem it requires PIL or ImageMagick, whereas fetchart is able to do the job with the fallback webproxy resizer.
53 lines
No EOL
2.1 KiB
ReStructuredText
53 lines
No EOL
2.1 KiB
ReStructuredText
EmbedArt Plugin
|
|
===============
|
|
|
|
Typically, beets stores album art in a "file on the side": along with each
|
|
album, there is a file (named "cover.jpg" by default) that stores the album art.
|
|
You might want to embed the album art directly into each file's metadata. While
|
|
this will take more space than the external-file approach, it is necessary for
|
|
displaying album art in some media players (iPods, for example).
|
|
|
|
This plugin was added in beets 1.0b8.
|
|
|
|
Embedding Art Automatically
|
|
---------------------------
|
|
|
|
To automatically embed discovered album art into imported files, just enable the
|
|
plugin (see :doc:`/plugins/index`). You'll also want to enable the
|
|
:doc:`/plugins/fetchart` to obtain the images to be embedded. Art will be
|
|
embedded after each album is added to the library.
|
|
|
|
This behavior can be disabled with the ``autoembed`` config option (see below).
|
|
|
|
Manually Embedding and Extracting Art
|
|
-------------------------------------
|
|
|
|
The ``embedart`` plugin provides a couple of commands for manually managing
|
|
embedded album art:
|
|
|
|
* ``beet embedart IMAGE QUERY``: given an image file and a query matching an
|
|
album, embed the image into the metadata of every track on the album.
|
|
|
|
* ``beet extractart [-o FILE] QUERY``: extracts the image from an item matching
|
|
the query and stores it in a file. You can specify the destination file using
|
|
the ``-o`` option, but leave off the extension: it will be chosen
|
|
automatically. The destination filename defaults to ``cover`` if it's not
|
|
specified.
|
|
|
|
* ``beet clearart QUERY``: removes all embedded images from all items matching
|
|
the query. (Use with caution!)
|
|
|
|
Configuring
|
|
-----------
|
|
|
|
``autoembed`` option lets you disable automatic album art embedding.
|
|
To do so, add this to your ``~/.beetsconfig``::
|
|
|
|
[embedart]
|
|
autoembed: no
|
|
|
|
A maximum image width can be defined to downscale images before embedding them
|
|
(source image on filesystem is not altered). The resize operation reduces image width to
|
|
``maxwidth`` pixels and height is recomputed so that aspect ratio is preserved.
|
|
The [PIL](http://www.pythonware.com/products/pil/) or [ImageMagick](www.imagemagick.org/) is required
|
|
to use the ``maxwidth`` config option. |