mirror of
https://github.com/beetbox/beets.git
synced 2025-12-07 17:16:07 +01:00
38 lines
1.3 KiB
ReStructuredText
38 lines
1.3 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`. You'll need 2 additional python packages:
|
|
`pyxdg` and `pathlib`.
|
|
|
|
``thumbnails`` needs to resize the covers, and therefore requires either
|
|
`ImageMagick`_ or `Pillow`_.
|
|
|
|
.. _Pillow: https://github.com/python-pillow/Pillow
|
|
.. _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`).
|