A Java command line application to covert charset of id3 tags to UTF-8. Support auto charset detection and batch convertion.
Some of the media players, for example iTunes, support character set UTF-8 only. Create this simple tool to convert the tags' character set to UTF-8.
ID3 is a metadata container most often used in conjunction with the MP3 audio file format. It allows information such as the title, artist, album, track number, and other information about the file to be stored in the file itself.
From Wikipedia.
prerequisites: Java 8 or newer installed
- Download the zip or tar from github
- Extract to any folder
For Windows:
Execute
bin\id-charset-converter.bat [-c <CHARSET>] [-h] [-t] source [target]
For Mac / Unix-like / Linux-Like:
Execute
bin/id3-charset-converter [-c <CHARSET>] [-h] [-t] source [target]
- source (required): path of source file or folder
- target (optional): path of output file or folder
- -c or --charset: source CHARSET, auto-detected by title if not specify (! Detection is not 100% correct, suggest run --test before saving file)
- -d or --within-days: convert file's last modified within INPUT days
- -t or --test: test run without saving file(s)
- -h or --help: print help message
id3-charset-converter -c ISO-8859-1 ~/Downloads/input.mp3 /tmp/output.mp3
Convert all files under folder music in BIG5 modified within last 10 days and save converted file under the same folder
id3-charset-converter -d 10 -c BIG5 music
id3-charset-converter -t music/input.mp3
This is a personal project by Timmy Wong. The project is adopted TDD with code coverage almost 100%.
Feel free to contact thcathy@gmail.com if you want any new feature or bug fixing.
https://github.com/mpatric/mp3agic mp3agic: reading and writing id3 tags
http://site.icu-project.org/ ICU4J: auto character set detection