Missing Plugin

This plugin adds a new command, missing or miss, which finds and lists, for every album in your collection, which or how many tracks are missing. Listing missing files requires one network call to MusicBrainz. Merely counting missing files avoids any network calls.


Enable the plugin by putting missing on your plugins line in config file:



By default, the beet missing command lists the names of tracks that your library is missing from each album. You can customize the output format, count the number of missing tracks per album, or total up the number of missing tracks over your whole library. These options can either be specified in the config file:

    format: $albumartist - $album - $title
    count: no
    total: no

or on the command-line:

-f FORMAT, --format=FORMAT
                      print with custom FORMAT
-c, --count           count missing tracks per album
-t, --total           count total of missing tracks


The format option (default: list_format_item) lets you specify a specific format with which to print every track. This uses the same template syntax as beets’ path formats. The usage is inspired by, and therefore similar to, the list command.


The count option (default: false) prints a count of missing tracks per album, with format defaulting to $albumartist - $album: $missing.


The total option (default: false) prints a single count of missing tracks in all albums

Template Fields

With this plugin enabled, the $missing template field expands to the number of tracks missing from each album.


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

Print out a listing of all albums with missing tracks, and respective counts:

beet missing -c

Print out a count of the total number of missing tracks:

beet missing -t

Call this plugin from other beet commands:

beet ls -a -f '$albumartist - $album: $missing'


  • Add caching.