Duplicates Plugin

This plugin adds a new command, duplicates or dup, which finds and lists duplicate tracks or albums in your collection.


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

plugins: duplicates


By default, the beet duplicates command lists the names of tracks in your library that are duplicates. It assumes that Musicbrainz track and album ids are unique to each track or album. That is, it lists every track or album with an ID that has been seen before in the library.

You can customize the output format, count the number of duplicate tracks or albums, and list all tracks that have duplicates or just the duplicates themselves. These options can either be specified in the config file:

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

or on the command-line:

-f FORMAT, --format=FORMAT
                      print with custom FORMAT
-c, --count           count duplicate tracks or
-a, --album           show duplicate albums instead
                      of tracks
-F, --full            show all versions of duplicate
                      tracks or albums


The format option (default: list_format_item) lets you specify a specific format with which to print every track or album. 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 duplicate tracks or albums, with format hard-coded to $albumartist - $album - $title: $count or $albumartist - $album: $count (for the -a option).


The album option (default: false) lists duplicate albums instead of tracks.


The full option (default: false) lists every track or album that has duplicates, not just the duplicates themselves.


List all duplicate tracks in your collection:

beet duplicates

List all duplicate tracks from 2008:

beet duplicates year:2008

Print out a unicode histogram of duplicate track years using spark:

beet duplicates -f '$year' | spark

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

beet duplicates -ac

The same as the above but include the original album, and show the path:

beet duplicates -acf '$path'


  • Allow deleting duplicates.

Project Versions

Table Of Contents

Previous topic

Missing Plugin

Next topic

Discogs Plugin

This Page