Backup_Repos/beets
1
0
Fork 0
mirror of https://github.com/beetbox/beets.git synced 2025-12-06 08:39:17 +01:00
Code Issues Projects Releases Wiki Activity

Update missing plugin configuration options and formatting details

Browse source
This commit is contained in:
Alok Saboo 2025-09-17 13:25:20 -04:00 committed by Šarūnas Nejus
parent 2c1aa27385
commit 76c049938c
1 changed files with 12 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

19
docs/plugins/missing.rst
View file

@ -39,21 +39,26 @@ Configuration
To configure the plugin, make a ``missing:`` section in your configuration file. To configure the plugin, make a ``missing:`` section in your configuration file.
The available options are: The available options are:
- **count**: Print a count of missing tracks per album, with ``format`` - **count**: Print a count of missing tracks per album, with the global
defaulting to ``$albumartist - $album: $missing``. Default: ``no``. ``format_album`` used for formatting. Default: ``no``.
- **format**: A specific format with which to print every track. This uses the
same template syntax as beets' :doc:`path formats </reference/pathformat>`.
The usage is inspired by, and therefore similar to, the :ref:`list <list-cmd>`
command. Default: :ref:`format_item`.
- **total**: Print a single count of missing tracks in all albums. Default: - **total**: Print a single count of missing tracks in all albums. Default:
``no``. ``no``.
Formatting
~~~~~~~~~~
- This plugin uses global formatting options from the main configuration; see :ref:`format_item` and :ref:`format_album`:
- :ref:`format_item`: Used when listing missing tracks (default item format).
- :ref:`format_album`: Used when showing counts (``-c``) or missing albums (``-a``).
Here's an example Here's an example
:: ::
format_album: $albumartist - $album
format_item: $artist - $album - $title
missing: missing:
format: $albumartist - $album - $title
count: no count: no
total: no total: no