This is my very first Mp3tag Web Sources Script (WSS).
It collects metadata from MusicBrainz using the JSON-based MusicBrainz API.
Please scroll down for the download- and installation instructions.
Like any other Web Sources Script it will add tags and metadata to all your selected files.
Metadata in already existing tags will be replaced without any further information or reconfirmation!
The main objectives for this WSS are:
1.) Best possible compatibility to MusicBrainz official tagger "Picard"
2.) Using JSON (instead of XML)
This script is working best with a complete release (most of us are using the term "Album").
The first overview "List of search results..." after a search by
Artist + Album
- Catalog number
is listing all available relases/albums with the additional columns "No of media" (1), ASIN (2), Barcode (3) and Status (4). This should help you to identify the correct release for your tracks ready to be tagged.
The main "Adjust tag information" window let you check if you really have found the matching release.
Most important are the track titles and track lengths. Sometimes tracks do not appear in the correct sort order. Then you can Move Up or Move Down your local filename on the right side to the correct place.
In addition to the usual tags (like Artist, Album, Year, Track, Title and various sort tags and various MusicBrainz IDs)
the following expanded tags will be filled ***, if available:
SetSubtitle (Disc/Media Subtitles)
INVOLVEDPEOPLE (only Instrument-/Vocal Performer for the release)
If you don't need all the dozens of tags *** offered by this Web Sources Script, you can easily remove them inside this script. Just open the linked
*.inc file in a text editor and scroll down to the bottom of the script. Remove the # sign in front of every tag not needed.
If you don't need the tag Publisher/Record Label, go to the line with
and change it to
Save the file.
If you don't need the hint in your Comment tag
If you don't need the hint in your Comment tag that this script wrote data into your tags, go to the line with
and change it to
Save the file.
*** The number of tags highly depends on the existing data at MusicBrainz.
Not every release has a complete set of all tags. All these metadata have been provided by users like you and me.
The exceptions to the main objective "compatibility to MB Picard" are:
a) This script does NOT manipulate the official MusicBrainz metadata in any way.
- That means, there is no change to lowercase for the primary and secondary "Release Type" like "Album" or "Compilation".
- There is no change to lowercase for the "Release Status" like "Official".
- There is no apostrophe replacement for
- There is no ISRC formatting.
- There is no filtering of duplicate Catalog-Numbers from different Labels.
- All metadata are written 1:1 as delivered from the source.
- If you want to format such metadata, please use the according Actions from Mp3tag.
b) This script does NOT map any source tag to target tag.
- That means, there is no "live sound" transformed into Engineer or "orchestrator" into Arranger.
- All types of relationships will be filled 1:1 into the INVOLVEDPEOPLE tag.
There are only a few exceptions with own tags like COMPOSER, CONDUCTOR, LYRICIST, WORK, WRITER
(Hint: MB Picard also shows the Mixer or Engineer or Producer as separate tags, but merge it together with all kind of Instrument- and Vocal-Performers into the same INVOLVEDPEOPLE tag).
c) If you want to modify the tag
SetSubtitle in both programs, Mp3tag AND MB Picard, you have to add this two Tagger Script Lines in MB Picard (Options -> Options -> Scripting -> Tagger Scripts):
Details about this topic.
Some Cover Art pictures from MusicBrainz can be huge!
You will find pictures with more then 4000x Pixels and sizes about 50 MB and more.
Downloading and preview take a lot of time, because the Cover Art Archive isn't the fastest delivering source. If you think Mp3tag freezes during the search for tag data, then it is very likely that a huge cover will be downloaded. Please be patient.
Since Mp3tag v3.11h (released 2022-01-14) one of the 4 available "MusicBrainz Cover Size" in Tools -> Options -> Tag Sources: 250 Pixels, 500 Pixels, 1200 Pixels or the Original size can be configured.
This script doesn't resize the picture in any way, it just download the predefined size from the MusicBrainz Cover Art Archive. If you like the biggest available cover picture (and are patiently waiting for the download), then configure the size to "Original".
Newest Mp3tag, at least v3.11h
Important: This WSS will NOT work with older Mp3tag versions!
MusicBrainz expanded v1.00.zip (10,8 KB)
Last Modified: 2022-01-15
- Download the above
.zipand extract it to the
(Just hit Win+R and copy & paste
Or you can click on menu
Open configuration folderand then open the folder
\dataand open the subfolder
- You can access all WS scripts either by using the menu
Tag sourcesor by right-clicking on the selected tracks and
Please let me know if you have found any error or inconsistency using this script.
Attach a screenshot with your current result and your expected values.
Don't forget to note the MusicBrainz release ID, where the source data is available.
If you prefer, write such info in a PM.