mirror of
https://github.com/beetbox/beets.git
synced 2025-12-20 23:53:15 +01:00
71 lines
1.6 KiB
ReStructuredText
71 lines
1.6 KiB
ReStructuredText
Missing Plugin
|
||
==============
|
||
|
||
This plugin adds a new command, ``missing`` or ``miss``, which finds
|
||
and lists, for every album in your collection, which tracks are
|
||
missing. Listing missing files requires one network call to
|
||
MusicBrainz.
|
||
|
||
Installation
|
||
------------
|
||
|
||
Enable the plugin by putting ``missing`` on your ``plugins`` line in
|
||
:doc:`config file </reference/config>`::
|
||
|
||
plugins:
|
||
missing
|
||
...
|
||
|
||
Configuration
|
||
-------------
|
||
|
||
The plugin accepts a single configuration directive, ``format``,
|
||
either in your configuration file::
|
||
|
||
missing:
|
||
format: FMTSTR
|
||
|
||
or in the command-line::
|
||
|
||
$ beet missing --help
|
||
Usage: beet missing [options]
|
||
|
||
Options:
|
||
-h, --help show this help message and exit
|
||
-f FORMAT, --format=FORMAT
|
||
print with custom FORMAT
|
||
|
||
format
|
||
~~~~~~
|
||
|
||
The ``format`` option (default: ``None``) lets you specify 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.
|
||
|
||
Examples
|
||
-------------------------
|
||
|
||
List all missing tracks in your collection::
|
||
|
||
beet missing
|
||
|
||
List all missing tracks from 2008::
|
||
|
||
beet missing year:2008
|
||
|
||
Print out a unicode histogram of the missing track years using `spark`_::
|
||
|
||
beet missing -f '$year' | spark
|
||
▆▁▆█▄▇▇▄▇▇▁█▇▆▇▂▄█▁██▂█▁▁██▁█▂▇▆▂▇█▇▇█▆▆▇█▇█▇▆██▂▇
|
||
|
||
|
||
TODO
|
||
----
|
||
|
||
- Add caching.
|
||
|
||
--------------
|
||
|
||
.. _spark: https://github.com/holman/spark
|