Skip to content
user defined keyword tags for beets
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.
beetsplug fixing __future__ import Aug 21, 2016 Merge pull request #6 from Nagasaki45/query Oct 22, 2018


Provides user defined keyword tags for beets. It provides three new commands to add and remove tags and to clear all tags from a file. These are specifically:

beet addtag <query> -t <usertag>[ -t <other-usertag>[...]]

Adds one (or more) usertags to the track with the given id.

beet rmtag <query> -t <usertag>[ -t <other-usertag>[...]]

Removes a usertag from the track with the given id.

beet cleartags <query>

Strips all usertags from the track with the given id.

beet listtags

Lists all user defined tags and a count of tracks that used those tags.

beet list usertags:my-tag

Query user tags as you would query any other field with the standard list command.


First, install the package with pip:

pip install git+git://

Alternatively, put the beetsplug folder somewhere in your PYTHONPATH.

Then, activate the plugin by adding usertag to the list of plugins in in beets' config.yaml file. This is described in more detail in the beets documentation.

You can’t perform that action at this time.