Plugins

Plugins can extend beets’ core functionality. Plugins can add new commands to the command-line interface, respond to events in beets, augment the autotagger, or provide new path template functions.

Using Plugins

To use a plugin, you have two options:

  • Make sure it’s in the Python path (known as sys.path to developers). This just means the plugin has to be installed on your system (e.g., with a setup.py script or a command like pip or easy_install).
  • Set the pythonpath config variable to point to the directory containing the plugin. (See Command-Line Interface.)

Then, set the plugins option in your ~/.beetsconfig file, like so:

[beets]
plugins = mygreatplugin someotherplugin

The value for plugins should be a space-separated list of plugin module names.

Plugins Included With Beets

There are a few plugins that are included with the beets distribution. They’re disabled by default, but you can turn them on as described above:

Other Plugins

Here are a few of the plugins written by the beets community:

Writing Plugins

If you know a little Python, you can write your own plugin to do almost anything you can imagine with your music collection. See the guide to writing beets plugins.

Table Of Contents

Previous topic

Queries

Next topic

Chromaprint/Acoustid Plugin

This Page