mirror of
https://github.com/beetbox/beets.git
synced 2025-12-06 08:39:17 +01:00
aa31fea037
*All* URLs were checked manually, but only once per domain! I mostly concerned myself with URLs in documentation rather than source code because the latter may or may not have impactful changes, while the former should be straight forward. Changes in addition to simply adding an s: - changed pip and pypi references as their location has changed - MPoD (iOS app) url redirects to Regelian, so I replaced those - updated homebrew references Notable observations: - beets.io does have HTTPS set up properly (via gh-pages) - beatport.py uses the old HTTP url for beatport - as does lyrics.py for lyrics.wikia.com - https://tomahawk-player.org/ expired long ago, but the http page redirects to https regardless - none of the sourceforge subdomains have https (in 2019!)
38 lines
1.3 KiB
ReStructuredText
38 lines
1.3 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 it (see :doc:`/plugins/index`) as well
|
|
as the :doc:`/plugins/fetchart`. You'll need 2 additional python packages:
|
|
:pypi:`pyxdg` and :pypi:`pathlib`.
|
|
|
|
``thumbnails`` needs 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`).
|