In many cases Vocaloid albums (especially the rarer ones) aren’t recognized by any of the auto-tagging systems that use either Gracenote (WinAmp, Windows Media Player, iTunes) or FreeDB (foobar). In those cases you often have to apply tags manually. But why do something manually when you can automate it? Here’s a hopefully useful tip for using VocaDB to tag your Vocaloid albums in the way you want.


For this, you can use the “Download track info as CSV” button. If you press the button itself it will download tags in default format which assumes you want the Vocaloids listed in the title, or not at all. The default format is this because many media players and services such as are unable to group songs properly by artist if you have artists such as 164 feat. Hatsune Miku and 164 feat. Kagamine Rin in your library. Regardless, some people wish to tag their songs so that the Vocaloids are listed in the artist field. In that case you must press the down arrow next to the button and enter a custom format string, for example “%title%;%artist%;%album%;%discnumber%;%track%”. There are also plenty of other formatting fields such as genres that you can include as needed.


After downloading the CSV file, open the album in mp3tag (there might be other tagging tools that can be used). Make sure all songs are selected (you can press CTRL+A) and select Convert -> Text file – tag (or press ALT+4).


Find the CSV file and enter the mp3tag format string matching the format string from VocaDB. The default mp3tag format string is “%dummy%;%title%;%artist%;%album%;%discnumber%;%track%”, or if you used the alternate format string from above, the matching mp3tag format string is “%title%;%artist%;%album%;%discnumber%;%track%”. The possible field names are available in mp3tag’s context menu as well as their help page. Then just press Ok and you’re done! You can even use mp3tag to rename the files to match the tags.

We’re considering of adding native support for FreeDB API so that you could use players such as foobar to download tags with even less manual work, but for now this is the easiest way to tag your Vocaloid albums the way you want.

9 thoughts on “Tagging Vocaloid albums using VocaDB and mp3tag”

  1. Thanks Riipah,
    I personally solved the artist / vocaloid issue by reserving the artist field to the actual composer and putting the Vocaloid in the “album artist” field. There’s also the possible use of the “composer” MP3 field, but I use it exclusivly for my Classical works. Though to be honest, depending on your mp3 player software, there is no consistent way of handling the Composer, Album Artist and Artist fields :'( Some are not managing all of them or arbitrarily displaying only one. But good software will handle both and let you find a song either with artist, album artist or composer.
    And then of course we have not solved the matter of UNICODE and dual representation of a song which is an other can of worms. The best way to tackle this I have seen is MusicBrainz localization templates, where you create phantom entries for your titles with the translation, maybe a design idea for you when you upgrade VocaDB

  2. The composer field is not one of the “official” fields, that’s why only some players support it, which can be a problem if you’re playing music on mobile devices. Nevertheless, you should be able to make use of that field with VocaDB tag download and mp3tag, since mp3tag supports the composer field.

    Personally I’ve been using the album artist for circles and labels, covering the whole album, and the artist field for producers of individual songs.

    I don’t really understand what you mean by the “dual representation of a song”. Can you give me an example? mp3tag is able to read tags in multiple encodings at least.

  3. Is there any way of getting the translated song titles and artist names rather than the Japanese versions?

    1. It should respect your language setting. In the account menu on the top -> change the preferred display language to English.

    1. Looks interesting… seems there are parser scripts for XML data, which could of course be provided by VocaDB. Still, the parser scripts aren’t exactly “easy”. Could be possible, not sure if I have time to do it myself.

  4. Apologies for the necro, but this was great in tagging new Voca albums from C93. Thanks a lot for the help!

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.