vgm_tag
ValleyBell's command-line tagger from the VGM Tools.
If you are used to the command line or BAT files, vgm_tag may be even faster to use than the GUI taggers. For instance, to change all System tags for VGMs in a folder, you could easily do:
for %V in (*.vg*) do vgm_tag -System:SMD "%V"
See also this forum topic for a program that makes command line functions very easy (on Windows).
Usage
vgm_tag [-command1] [-command2] file1.vgm file2.vgz
General Commands
| Command | Description |
|---|---|
| (no command) | like -ShowTag |
| -Help | Show this help |
| -SysList | Show the System List |
| -RemoveTag | Remove the GD3 tag (following commands are ignored) |
| -ClearTag | Clear the GD3 tag |
| -ShowTag | Shows the GD3 (HTML NCRs are used to display Unicode-Chars |
| -ShowTagU | like above, but tries to print real Unicode-Chars |
| -ShowTag8 | like above, but UTF-8 is used to print Unicode-Chars |
| -TitleCase | applies title case to the EN title tag and puts the original case in the JP title tag |
Tagging Commands
Command names are case insensitive. "Japanese" is now "Home Region", except for System shortcuts - but these commands still end with J in the name. Without it, they refer to the English fields.
Command formats:
-command:value -command:"value with spaces"
| Command | Description |
|---|---|
| Title[J] | Track Title (English and Home region, respectively) |
| Author[J] | Track Composer/Author |
| Game[J] | Game Name |
| System | Accept any text (should be a Platform name, of course), or a short name from the System List (see below).
If this command receives a short name, Otherwise, |
| System[E or J] | Same as System, but fills only that field.
|
| Year | Earliest-known release date of the Game. |
| Creator | VGM Creator; that's probably you. Trimmers are also considered to be creators of a given vgm. |
| Notes | Notes and Comments (replace contents with value) |
| NotesB | Insert value at beginning of existing Notes |
| NotesE | Insert value at end of existing Notes |
| NotesStripAt | "Notes tag: strip parameter + rest"; this case-sensitive command removes the first appearance of the given text (strip parameter), plus everything that comes after it.
Useful for clearing unwanted info at the end of tags, like the |
See Filling Out the Tags and Text File for more detailed instructions on the values to use.
Inserting Special Characters
To use " characters in any field/command, escape them like so:
vgm_tag -Title:"\"Tah-Dah\"" "066 'Tah-Dah'.vgm"
To add lines in comments, insert \n where you want to put them.
To use non-Latin characters, like Japanese or Korean ones, in any field, use the "Print NCRs" feature of VGMTool to be sure they go in correctly.
A Note on Notes
You can combine the Notes commands, and they'll be applied in order.
vgm_tag -NotesStripAt:Tangerines. -NotesE:" Tangerines and for Flamin' Yawn (Level Ate boss)." "02 Tangerine.vgm"
Notes Strip: "Tangerines." removed. Set NotesE = Tangerines and for Flamin' Yawn (Level Ate boss). Tag written.
System List
*s and ?s below are wildcards, such that using IM62 will produce "Irem M62".
| Shorthand | System |
|---|---|
| SMS | Sega Master System |
| SGG | Sega Game Gear |
| SMSGG | Sega Master System / Game Gear |
| SMD | Sega Mega Drive / Genesis |
| SG1k | Sega Game 1000 |
| SC3k | Sega Computer 3000 |
| SS* | Sega System * |
| CPS | CP System |
| CPS2 | CP System II |
| CPS3 | CP System III |
| Ccv | ColecoVision |
| BMM* | BBC Micro Model * |
| BM128 | BBC Master 128 |
| Arc | Arcade Machine |
| NGP | Neo Geo Pocket |
| NGPC | Neo Geo Pocket Color |
| SCD | Sega Mega-CD / SegaCD |
| 32X | Sega 32x |
| SCD32 | Sega Mega-CD 32X / Sega CD 32X |
| Nmc* | Namco System * |
| SX | Sega X |
| SY | Sega Y |
| SGX | System GX |
| AS? | Atari System ? |
| BS | Bubble System |
| IM* | Irem M* |
| TW16 | Twin 16 |
| NG | Neo Geo |
| NG* | Neo Geo * |
| NES | Nintendo Entertainment System |
| FDS | Famicom Disk System |
| NESFDS | Nintendo Entertainment System / Famicom Disk System |
| GB | Game Boy |
| GBC | Game Boy Color |
| GBGBC | Game Boy / Game Boy Color |
| GBA | Game Boy Advance |
| TG16 | TurboGrafx-16 |
| TGCD | TurboGrafx-CD |
| Tp? | Toaplan ? |
| VB | Virtual Boy |