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_.

.. _imagemagick: https://imagemagick.org/

.. _pillow: https://github.com/python-pillow/Pillow

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`).
