Add doc page for freedesktop plugin.

This commit is contained in:
kerobaros 2014-11-02 22:16:33 -06:00
parent 6ca34632de
commit a85069c4ec

View file

@ -0,0 +1,25 @@
Freedesktop Plugin
==================
The ``freedesktop`` plugin creates .directory files in your album folders. This
allows, when using a freedesktop.org compliant file manager, such as
Dolphin or Nautilus, an album to have its cover art as the folder's thumbnail.
To use the ``freedesktop`` plugin, enable it (see :doc:`/plugins/index`).
Configuration
-------------
To configure the plugin, make a ``freedesktop:`` section in your configuration
file. The only available option is:
- ``auto``: Create .directory files automatically during import.
Default: ``no``
Creating .directory Files Manually
----------------------------------
The ``freedesktop`` command provided by this plugin creates .directory files
for albums that match a query (see :doc:`/reference/query`). For example, ``beet
freedesktop man the animal cannon`` will create the .directory file for the
folder containing the album Man the Animal Cannon.