AcousticBrainz Submit Plugin¶
absubmit plugin lets you submit acoustic analysis results to the
absubmit plugin requires the streaming_extractor_music program
to run. Its source can be found on GitHub, and while it is possible to
compile the extractor from source, AcousticBrainz would prefer if you used
their binary (see the AcousticBrainz FAQ).
pip install requests
After installing both the extractor binary and requests you can enable
absubmit in your configuration (see Using Plugins).
To run the analysis program and upload its results, type:
beet absubmit [-f] [-d] [QUERY]
By default, the command will only look for AcousticBrainz data when the tracks
don’t already have it; the
--force switch makes it refetch
data even when it already exists. You can use the
to check which files will be analyzed, before you start a longer period
The plugin works on music with a MusicBrainz track ID attached. The plugin
will also skip music that the analysis tool doesn’t support.
streaming_extractor_music currently supports files with the extensions
To configure the plugin, make a
absubmit: section in your configuration
file. The available options are:
- auto: Analyze every file on import. Otherwise, you need to use the
beet absubmitcommand explicitly. Default:
- extractor: The absolute path to the streaming_extractor_music binary.
Default: search for the program in your
- force: Analyze items and submit of AcousticBrainz data even for tracks
that already have it.
- pretend: Do not analyze and submit of AcousticBrainz data but print out
the items which would be processed.