Mp3tag Web Sources Scripts

Table of Contents

• Information
  • Description
  • Status
• Step-by-Step Instructions on Adding Web Sources Scripts to Mp3tag
  • macOS
  • Windows
• Step-by-Step Instructions on Using Web Sources Scripts in Mp3tag
  • macOS
  • Windows
• Commented-Out Tag Fields in the Web Sources Scripts
• Questions About the Web Sources Scripts
  • How do I change the purchasing country?
  • How do I complete the XID tag field?
  • How do I get a genre ID that is not listed in the web sources scripts?
  • How do I get music metadata from a country of Apple Music or iTunes Store that is not available in this repository?
• Additional Information
• License

Information

Description

This repository contains web sources scripts for Mp3tag that will allow for the databases of Apple Music and the iTunes Store to be used to update music metadata. These web sources scripts for Mp3tag can automatically add tags to any song available on Apple Music and/or the iTunes Store. For these web sources scripts to work, the Apple Music or iTunes Store URL of a song is needed, which can be easily obtained by clicking on "Copy Link" in Apple Music or the iTunes Store.

The web sources scripts in this repository include some modifications that were made by me. The original web sources scripts without any of these modifications can be located at a forum called Mp3tag Community. Special thanks to AreDigg on Mp3tag Community for making the original versions of the Apple Music and iTunes Store web sources scripts.

Status

• Apple Music Web Sources Script: Working
• iTunes Store Web Sources Script: Working

Step-by-Step Instructions on Adding Web Sources Scripts to Mp3tag

macOS

1. Download Mp3tag from the official website (Official Version)
2. Install Mp3tag on your macOS device and open it
3. Download the web sources scripts from this repository
4. Click on "Tag Sources" in the menu bar
5. Click on "Open Tag Sources Folder"
6. Drag and drop the web sources scripts into the "Sources" folder that is opened by the application

Windows

1. Download Mp3tag from the official website (Official Version or Beta Version)
2. Install Mp3tag on your Windows device and open it
3. Download the web sources scripts from this repository
4. Move the .inc and .src files to %appdata%\mp3tag\data\sources

Step-by-Step Instructions on Using Web Sources Scripts in Mp3tag

macOS

1. Open Mp3tag
2. Select the song(s) that you want to retrieve metadata for
3. Click on "Tag Sources" in the menu bar
4. Hover over Apple Music or iTunes Store
5. Select the country that you want to get your metadata from
6. Paste an Apple Music or iTunes Store URL into the text box
7. Click on "Search"
8. Select the correct album
9. Click on "Next"
10. Compare the bottom two boxes and check if your song(s) is/are in the right order/placement
11. Click on "Merge" or "Save" to complete the process

Windows

1. Open Mp3tag
2. Select the song(s) that you want to retrieve metadata for
3. Click on "Tag Sources" in the toolbar
4. Hover over Apple Music or iTunes Store
5. Select the country that you want to get your metadata from
6. Paste an Apple Music or iTunes Store URL into the text box
7. Click on "Next >"
8. Check if it is the correct album
9. Compare the bottom two boxes and check if your song(s) is/are in the right order/placement
10. Click on "OK" to complete the process

Commented-Out Tag Fields in the Web Sources Scripts

There are three commented-out tag fields in these web sources scripts because these three tag fields will contain your personal information and will have to be edited by you. The three commented-out tag fields are the following: ITUNESACCOUNT, ITUNESOWNER, and ITUNESPURCHASEDATE. You can leave these commented-out codes alone if you do not want to attach your personal information to your songs.

ITUNESACCOUNT - Your Email Address
ITUNESOWNER - Your Name
ITUNESPURCHASEDATE - Date of Purchase (Year-Month-Day Hour:Minute:Second)

Questions About the Web Sources Scripts

Q: How do I change the purchasing country?

A: For these web sources scripts in this repository, the default purchasing country is the United States. If you do not want the United States to be the purchasing country, you will have to change the iTunes storefront ID in the .inc file. You can find the iTunes storefront ID in the .inc file by searching for the line that has ITUNESCOUNTRYID in it. After finding that line, you should look at the next line. Now, you will be able to change the purchasing country by deleting "143441" and then adding a different iTunes storefront ID. To find the iTunes storefront IDs, you can click on this link.

Purchasing Country Example (Germany):

OutputTo "ITUNESCOUNTRYID"
Say "143443"
Say "|"

Q: How do I complete the XID tag field?

A: The Apple Music web sources script only gets the International Standard Recording Code (ISRC) for the XID tag field. Two other parts are needed to complete the XID tag field. One of those parts is the content provider, which is the company that distributes the music. To get the content provider, you will have to search for them online, but I have listed some common content providers in this text file. The other part is just the word ISRC in lowercase letters. In total, there are three parts to the XID tag field, and they are separated from each other by colons.

XID Format:
Content Provider:isrc:Actual ISRC

XID Example:

SonyBMG:isrc:USSM19922509

Q: How do I get a genre ID that is not listed in the web sources scripts?

A: Some of the most common genre IDs are already accounted for in these web sources scripts. However, if there is a genre ID that is not listed in web sources scripts, you can add that genre ID in the .inc file by searching for the line that says ITUNESGENREID and following the same format as the other genre IDs. To find more genre IDs, you can click on this link. If you are using the link that I provided in the previous sentence, you should make sure that you are looking at category #34 because this category is the one that contains the genre IDs for music.

Q: How do I get music metadata from a country of Apple Music or iTunes Store that is not available in this repository?

A: You will have to go to the .src file and change the country code in it. To find the country codes, you can click on this link or this link. Also, you are able to change the language of the music metadata by changing the language parameter (l for Apple Music and lang for iTunes Store) in that same place.

Country Code Example for Apple Music Script (Germany):

[IndexUrl]=https://music.apple.com/de/search?l=en&term=%s

Country Code Example for iTunes Store Script (Germany):

[IndexUrl]=https://itunes.apple.com/search?country=de&lang=en_us&entity=album&term=%s
[AlbumUrl]=https://itunes.apple.com/lookup?country=de&lang=en_us&entity=song&limit=200&id=

Additional Information

• To find more web sources scripts for Mp3tag, click on this link
• To learn more about how to use web sources scripts in Mp3tag, click on this link
• To learn more about the APIs, click here for the Apple Music API and click here for the iTunes Store API
• To learn more about the syntax of these web sources scripts for Mp3tag, click on this link
• To learn more about the tag fields in Mp3tag, click on this link
• To learn more about the XID tag field, click on this link

License

The Unlicense