How to Submit Analyses to AcousticBrainz: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
No edit summary
No edit summary
Line 1: Line 1:
When adding a release or a single recording to MusicBrainz, it is recommended to submit AcousticBrainz analyzes for all of the added material too. This How-To explains this process as part of the (usual) workflow:
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.
* At first, the release or recording is (manually) [[How_to_Add_a_Release|added in MusicBrainz]].
* After that, the relevant files (recordings) are [https://picard.musicbrainz.org/docs/guide tagged with picard].
* Last but not least, the AcousticBrainz analyzes are submitted.


== Prerequisites ==
This step is the last step, because all files need to have a [[MusicBrainz_Identifier| MBIDs]] to be able to get analyzed for [http://acousticbrainz.org AcousticBrainz]. MBIDs are automatically added when the files are tagged with Picard (that's why this has to be done before). In the following there are two ways described, how to analyze and submit those analyzes to AcousticBrainz.


To analyze one or more recordings (for example as part of a whole release) you need to have the following:
== AcousticBrainz Analyze (GUI, only for Windows) ==


For this, [https://acousticbrainz.org/download AcousticBrainz-GUI] is needed.
* A working AcousticBrainz client, downloadable at the [https://acousticbrainz.org/download AcousticBrainz website] - at this time, only Windows, OSX and Linux are supported

Open '''acousticbrainz-gui.exe''' and select the folder with the files (should be the same folder) and click "Analyze...".
* The music files (preferably lossless), which have to be properly tagged with [[MusicBrainz_Identifier| MBIDs]] - if you don't know how to do this, read the [https://picard.musicbrainz.org/docs/guide 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...".


[[File:Analyze1.png|300px]]
[[File:Analyze1.png|300px]]
Line 18: Line 27:


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



:{{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.
:{{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).
Other than this, you have to do nothing, because the program automatically submits the analyzes to the AcousticBrainz server when you are connected to the internet.


== AcousticBrainz Analyze (Command line, Linux) ==
=== 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:
For this, an [https://acousticbrainz.org/download AcousticBrainz Client] for Linux is needed.


[[File:Analyze_Linux1.png|300px]]
Download the client according to your OS-Type and extract it.
Now open the extracted folder and create a folder named whatever you like, in this example it is "Music". Put all files you want to analyze in this new created folder.


[[File:Analyze_Linux1.png]]


Wait until the process is finished.


[[File:Analyze-Linux2.png|300px]]
Open the (abzsubmit) folder in the terminal and use the following command to analyze and submit all the files in the "Music" folder: ''./abzsubmit Music''


[[File: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 programm will directly show the :) smiley followed by the word "done".


== Have a look at your submits ==
Now wait until the process is finished.


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 [https://musicbrainz.org MusicBrainz] as part of the recordings' URL or at the recordings' details.
After that, you basically completed the whole process of adding a release/recording.





Revision as of 14:30, 4 January 2017

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

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 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:

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 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
Basic How-Tos
Specific How-Tos