mirror of
https://github.com/beetbox/beets.git
synced 2026-01-04 23:12:51 +01:00
39 lines
1.4 KiB
ReStructuredText
39 lines
1.4 KiB
ReStructuredText
Thumbnails Plugin
|
|
==================
|
|
|
|
The ``thumbnails`` plugin creates thumbnails your for album folders with the
|
|
album cover. This works on freedesktop.org-compliant file managers such as
|
|
Nautilus or Thunar, and is therefore POSIX-only.
|
|
|
|
To use the ``thumbnails`` plugin, enable it (see :doc:`/plugins/index`) as well
|
|
as the :doc:`/plugins/fetchart`. As with :doc:`/plugins/embedart`, be sure to
|
|
put ``fetchart`` before ``thumbnails`` in the ``plugins`` section of your
|
|
config. You'll need 2 additional python packages: `pyxdg` and `pathlib`.
|
|
|
|
``thumbnails`` needs to resize the covers, and therefore requires either
|
|
`ImageMagick`_ or `PIL`_.
|
|
|
|
.. _PIL: http://www.pythonware.com/products/pil/
|
|
.. _ImageMagick: http://www.imagemagick.org/
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
To configure the plugin, make a ``thumbnails`` section in your configuration
|
|
file. The available options are
|
|
|
|
- **auto**: Whether the thumbnail should be automatically set on import.
|
|
Default: ``yes``.
|
|
- **force**: Generate the thumbnail even when there's one that seems fine (more
|
|
recent than the cover art).
|
|
Default: ``no``.
|
|
- **dolphin**: Generate dolphin-compatible thumbnails. Dolphin (KDE file
|
|
explorer) does not respect freedesktop.org's standard on thumbnails. This
|
|
functionality replaces the :doc:`/plugins/freedesktop`
|
|
Default: ``no``
|
|
|
|
Usage
|
|
-----
|
|
|
|
The ``thumbnails`` command provided by this plugin creates a thumbnail for
|
|
albums that match a query (see :doc:`/reference/query`).
|