Skip to main content
`Ctrl`+`K`

# AcousticBrainz Plugin

The `acousticbrainz` plugin gets acoustic-analysis information from the AcousticBrainz project. This plugin is now deprecated since the AcousicBrainz project has been shut down.

As an alternative the beets-xtractor plugin can be used.

Enable the `acousticbrainz` plugin in your configuration (see Using Plugins) and run it by typing:

    $ beet acousticbrainz [-f] [QUERY]

By default, the command will only look for AcousticBrainz data when the tracks doesn’t already have it; the `-f` or `--force` switch makes it re-download data even when it already exists. If you specify a query, only matching tracks will be processed; otherwise, the command processes every track in your library.

For all tracks with a MusicBrainz recording ID, the plugin currently sets these fields:

- `average_loudness`

- `bpm`

- `chords_changes_rate`

- `chords_key`

- `chords_number_rate`

- `chords_scale`

- `danceable`

- `gender`

- `genre_rosamerica`

- `initial_key` (This is a built-in beets field, which can also be provided by Key Finder Plugin.)

- `key_strength`

- `mood_acoustic`

- `mood_aggressive`

- `mood_electronic`

- `mood_happy`

- `mood_party`

- `mood_relaxed`

- `mood_sad`

- `moods_mirex`

- `rhythm`

- `timbre`

- `tonal`

- `voice_instrumental`

## Warning

The AcousticBrainz project has shut down. To use this plugin you must set the `base_url` configuration option to a server offering the AcousticBrainz API.

## Automatic Tagging

To automatically tag files using AcousticBrainz data during import, just enable the `acousticbrainz` plugin (see Using Plugins). When importing new files, beets will query the AcousticBrainz API using MBID and set the appropriate metadata.

## Configuration

To configure the plugin, make a `acousticbrainz:` section in your configuration file. The available options are:

- auto: Enable AcousticBrainz during `beet import`. Default: `yes`.

- force: Download AcousticBrainz data even for tracks that already have it. Default: `no`.

- tags: Which tags from the list above to set on your files. Default: [] (all).

- base_url: The base URL of the AcousticBrainz server. The plugin has no function if this option is not set. Default: None