Greetings to the web sources community.
I'm copying my original post from [General Discussion] to [Development>Web Sources scripts] to facilitate the sharing of my script, and to make it easier to discuss improvements / modifications.
Please note this is NOT a finished product. It's still in development, due to a large oversight on my part.
Details are in this post.
After using pone's WS iTunes script(s) for years, I've finally decided to take up scripting and give a shot
at creating a tool with the functions I wanted. And the main one was create a script that could be
used internationally, i.e. I could somehow define what country the script would query.
This made sense to me, since if there was an artist from a certain country, or if an album had a localized
special edition, I would want to get metadata info from iTunes from that country. There are already WS scripts for several countries, but personally I find them cumbersome. I don't need scripts for 20+ countries if I mainly use just 2 or 3 and seldom use the rest. So that was my starting point.
So just download the script(s) of your choice to your Mp3Tag '\sources' folder and on Mp3Tag go to Tag Sources > iTunes WS and select the script you want to use.
The "Search by:" box has the following fields:
"Country:" Simply state which country you would like the script to query. Please use correct country codes or a bad request error will be generated. List of available country codes is available at ISO 3166-1 alpha-2 - Wikipedia. Check beforehand if iTunes is available in your desired country.
"Language:" / [clear] / en_us / ja_jp
On the Itunes API page is mentioned the possibility of displaying results from a non-English alphabet (e.g japanese) in English, or displaying search results in japanese charaters from the english alphabet, if provided by the database. For always displaying results in English, the 'language' field must have the value 'en_us'; for always displaying results in japanese, the value must be 'ja_jp'. Leaving the field blank will display the results as is. Other/incorrect values will return a bad request error message.
NB: Though the ja_jp option exists and is available, I have never had a query whose results were ported to japanese characters if they were not already the original writing system. Please take note of this if/when using the 'ja_jp' option.
"Query:" / [clear]
Standard query field; script will load artist and album info onto the filed, if said info is already present in the files. Manual input is also available. For direct results, you can search for a collection ID number (on the link https://music.apple.com/us/album/[album name]/123456789 the number 123456789 would be the collection ID to put in the query field).
This script is intended to be used in tandem with localized versions; as a tool to perform one-off searches of seldom searched countries, instead of having 20+ WS scripts cluttering the Tag Sources menu.
So, please enjoy using this script, as much as I enjoyed making it (and leave a like if you think the script is worth it).
- version 3.00 (check thread for history of changes)
- JPN - English returns latinized japanese, not translated.
iTunes is responsible for providing alternative language versions of their data. Their API page states 'English' language results. If you are unhappy with your results, contact Apple.
iTunes WS#[Any] - [Localized].src (6.7 KB) >> Blank 'Country' and 'Language' input fields
iTunes WS#JPN - English.src (6.7 KB) >> 'Country' preset to Japan (JP) and 'Language' preset to English (en_us)
iTunes WS#JPN - Japanese.src (6.7 KB) >> 'Country' preset to Japan (JP) and 'Language' preset to empty (original language)
iTunes WS#USA - English.src (6.7 KB) >> 'Country' preset to United States (US) and 'Language' preset to English (en_us)