
AcousticBrainz Plugin
*********************

The "acousticbrainz" plugin gets acoustic-analysis information from
the AcousticBrainz project.

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"

* "rhythm"

* "tonal"

* "voice_instrumental"


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. There is one option:

* **auto**: Enable AcousticBrainz during "beet import". Default:
  "yes".

* **force**: Download AcousticBrainz data even for tracks that already
  have it. Default: "no".
