Vgm tt

VGM Tag Transfer is one of the VGM Tools. It copies all tag fields from one or more VGM or VGZ files given first, to matching files given second. This is useful if you've had to relog VGM tracks for any reason.

Usage

vgm_tt [options] referenceDirOrFile destinationDirOrFile

To transfer tags from multiple VGMs, you must give directories/folders on each side holding the VGMs you want. By default, even if you give two VGMs, only matches are shown, and no action is taken.

The options are a little tricky to understand and require some detail. -m options are ignored when tags are transferred directly between VGMs. You can consider that transfer to be an "automatic match", for convenience.

-mtrim

Match directory files using their sample counts, a.k.a. trim points. This is the default matching mode.

Though this mode may seem overly precise, it can be useful. VGM tracks that successfully had silence trimmed by vgm_sptd or vgm_spts can use the same trim points as a previous recording without changes, ideally. When that happens, this mode will work. You can then use -rename to automatically rename the destination VGMs to match the reference ones.

Note: If in doubt, you can find out the number of samples of a song or loop using the programs mentioned in Finding Trim Points in WAV Files‎.

-mname

Match directory files using their file names.

-rename

Rename destination files to match the source files. Admittedly, I have not tried this option yet, but logic suggests it should function as described. It will only be useful if the match mode isn't -mname.

-tag

Actually transfer tags from the references to the destinations. If there are no tag fields set in the reference files, the destinations will stay unchanged. If even one tag field is set in the reference files, the entire tag will be copied, replacing any and all info inside the destination files. If you need more finely-grained transfer, try VGMToolbox, or VGMTool if your destination files have no existing GD3 tags.