AutoBPM Plugin#

The autobpm plugin uses the Librosa library to calculate the BPM of a track from its audio data and store it in the bpm field of your database. It does so automatically when importing music or through the beet autobpm [QUERY] command.

Install#

To use the autobpm plugin, first enable it in your configuration (see Using Plugins). Then, install beets with autobpm extra

pip install "beets[autobpm]"

Configuration#

To configure the plugin, make a autobpm: section in your configuration file.

Default#

autobpm:
    auto: yes
    force: no
    beat_track_kwargs: {}
    quiet: no

auto (default: yes)#: Analyze every file on import. Otherwise, you need to use the beet autobpm command explicitly.

force (default: no)#: Calculate a BPM even for files that already have a bpm value. Can also be set using the -f or --force flag.

overwrite (default: no)#: Deprecated since version 2.9: Use force instead.

beat_track_kwargs (default: {})#

Any extra keyword arguments that you would like to provide to librosa's beat_track function call, for example:

autobpm:
  beat_track_kwargs:
    start_bpm: 160

quiet (default: no)#: Suppress the message indicating that a file already has a bpm value. Can also be set using the -q or --quiet flag.