Skip to main content
`Ctrl`+`K`

# BPM Plugin

This `bpm` plugin lets you to get the tempo (beats per minute) of a song by tapping out the beat on your keyboard.

## Usage

To use the `bpm` plugin, first enable it in your configuration (see Using Plugins).

Then, play a song you want to measure in your favorite media player and type:

    beet bpm <song>

You’ll be prompted to press Enter three times to the rhythm. This typically allows to determine the BPM within 5% accuracy.

The plugin works best if you wrap it in a script that gets the playing song. for instance, with `mpc` you can do something like:

    beet bpm $(mpc |head -1|tr -d "-")

If import.write is `yes`, the song’s tags are written to disk.

## Configuration

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

- max_strokes: The maximum number of strokes to accept when tapping out the BPM. Default: 3.

- overwrite: Overwrite the track’s existing BPM. Default: `yes`.

## Credit

This plugin is inspired by a similar feature present in the Banshee media player.