How to Submit Analyses to AcousticBrainz
When adding a release or a single recording to MusicBrainz, it is recommended to submit AcousticBrainz analyzes for all of the added material too. These analyzes describe the acoustic characteristics of the music, including low-level spectral information and information for genres, moods, keys, scales and much more.
The process of analyzing music files (and submitting these analyzes to AcousticBrainz) is luckily full-automatic, so you just have to do the setup.
Prerequisites
To analyze one or more recordings (for example as part of a whole release) you need to have the following:
- A working AcousticBrainz client, downloadable at the AcousticBrainz website - at this time, only Windows, OSX and Linux are supported
- The music files (preferably lossless), which have to be properly tagged with MBIDs - if you don't know how to do this, read the Picard tutorial
It is recommended to put all the files in one folder, no matter if they are from different releases
Analyzing files
After extracting the downloaded packages, they are ready to use.
Windows
Open acousticbrainz-gui.exe and select the folder with the files and click "Analyze...".
Now wait until the process is finished:
- Note: This may take a while, so make sure to have a stable internet connection and preferably don't do anything else during this time on your computer.
As you can see, properly tagged files will be submitted, files without MBIDs will be skipped, so make sure to have the files properly tagged. Additionally, all previously analyzed files won't be analyzed a second time (when clicking analyze again); the programm will output, that there are no audio files in the selected folder (although there are, but have already been analyzed).
Linux
Open the extracted folder and open the terminal from this folder. Enter the command: ./abzsubmit [directory] to analyze all files at the given directory. This will be a single file or all files in a folder if the directory points to a folder. In this example, the files are in the "Music" folder which is located directly in the folder from where the terminal has to be opened:
Wait until the process is finished.
As you can see, properly tagged files will be submitted, files without MBIDs will be skipped, so make sure to have the files properly tagged. Additionally, all previously analyzed files won't be analyzed a second time (when trying to analyze again); the programm will directly show the :) smiley followed by the word "done".
Have a look at your submits
After having analyzed and submitted the files, you can see them at:
- acousticbrainz.org/api/v1/<MBID>/high-level
- acousticbrainz.org/api/v1/<MBID>/low-level
You just have to replace <MBID> with the related MBID of the recording you just submitted. This ID you have to look up manually, for example on MusicBrainz as part of the recordings' URL or at the recordings' details.
How-To Pages | |
---|---|
Introductory Guides | Beginners' Guide · Creating an Account · Editing · Voting · Writing Edit Notes |
Basic How-Tos | Adding an Artist · Adding Relationships · Using the Relationship Editor · Using Artist Credits · Adding a Release · Works · Events · Places · Series · Instruments · Areas |
Specific How-Tos | Merging Releases · Merging Recordings · Removing Entities · Adding Cover Art · Identifying Labels · Splitting Artists · Adding Standalone Recordings · Adding Disc IDs · Cancelling Edits · Searching for Edits · Reporting a User · Reporting an Issue · Working with AcoustIDs · Tagging Files with Picard |