Skip to content

Latest commit

 

History

History
65 lines (53 loc) · 1.89 KB

acousticbrainz.rst

File metadata and controls

65 lines (53 loc) · 1.89 KB
Raw

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 /plugins/keyfinder.)
  • 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 are three options:

  • 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)