How to Submit Analyses to AcousticBrainz: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
No edit summary
No edit summary
Line 19: Line 19:
=== Windows ===
=== Windows ===


Open '''acousticbrainz-gui.exe''' and select the folder with the files and click "Analyze...".
*Open '''acousticbrainz-gui.exe''' and select the folder with the files and click "Analyze...".


[[File:Analyze1.png|300px]]
[[File:Analyze1.png|300px]]




Now wait until the process is finished:
*Now wait until the process is finished:


[[File:Analyze2.png|300px]]
[[File:Analyze2.png|300px]]
Line 34: Line 34:
=== Linux ===
=== Linux ===


*Open the extracted folder and open the terminal from this folder.
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:
*Enter the command: ''./abzsubmit [path to file/folder]'' to analyze all files at the given path.

This can be a single file or all files in a folder if the path 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:


[[File:Analyze_Linux1.png|300px]]
[[File:Analyze_Linux1.png|300px]]




Wait until the process is finished.
*Wait until the process is finished.


[[File:Analyze-Linux2.png|300px]]
[[File:Analyze-Linux2.png|300px]]
Line 57: Line 60:
*acousticbrainz.org/<MBID>
*acousticbrainz.org/<MBID>


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 [https://musicbrainz.org MusicBrainz] as part of the recordings' URL or at the recordings' details.
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 in Picard (or another tag editing software). Alternatively you can find them on [https://musicbrainz.org MusicBrainz] as part of the recordings' URL or at the recordings' details.





Revision as of 21:48, 4 January 2017

When adding a release or a single recording to MusicBrainz, you should also submit AcousticBrainz analyses for all of the added material too. These analyses describe the acoustic characteristics of the music, including low-level spectral information and information for genres, moods, keys, scales and much more. For more information about AcousticBrainz, look here.

The process of analysing music files (and submitting these analyses 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 (if available use lossless files, otherwise lossy files will do it too), 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, because all files can then be analyzed at once and don't have to be analyzed seperately (For Windows this is even necessary, you can only choose folders to analyze there).

Analysing 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...".

Analyze1.png


  • Now wait until the process is finished:

Analyze2.png

Note 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 program 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 [path to file/folder] to analyze all files at the given path.

This can be a single file or all files in a folder if the path 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:

Analyze Linux1.png


  • Wait until the process is finished.

Analyze-Linux2.png


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 program will directly show ":) done".

Have a look at your submissions

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

Or for or a more general overview:

  • acousticbrainz.org/<MBID>

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 in Picard (or another tag editing software). Alternatively you can find them on MusicBrainz as part of the recordings' URL or at the recordings' details.


How-To Pages
Introductory Guides
Basic How-Tos
Specific How-Tos