mirror of
https://github.com/beetbox/beets.git
synced 2025-12-06 08:39:17 +01:00
42 lines
1.4 KiB
ReStructuredText
42 lines
1.4 KiB
ReStructuredText
Thumbnails Plugin
|
|
==================
|
|
|
|
The ``thumbnails`` plugin creates thumbnails for your 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 ``thumbnails`` and
|
|
:doc:`/plugins/fetchart` in your configuration (see :ref:`using-plugins`) and
|
|
install ``beets`` with ``thumbnails`` and ``fetchart`` extras
|
|
|
|
.. code-block:: bash
|
|
|
|
pip install "beets[fetchart,thumbnails]"
|
|
|
|
``thumbnails`` need to resize the covers, and therefore requires either
|
|
`ImageMagick`_ or `Pillow`_.
|
|
|
|
.. _Pillow: https://github.com/python-pillow/Pillow
|
|
.. _ImageMagick: https://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`).
|