vgm_ren
The VGM Renamer renames VGM/VGZ files based on context, as described in the sections below. With this program, you should never need to rename track files by hand to get the right order and names.
How It Works
Drag-and-drop a VGM, VGZ, or M3U playlist file onto vgm_ren. Or, run vgm_ren and enter the name of the file when prompted.
vgm_ren does not change the GD3 tags of VGM files. If it tries to give a VGM a filename that already exists, the rename will fail and the other file won't be changed.
To keep changed filenames consistent in an M3U playlist file, it will modify the playlist file only. Should there be any mistakes, simply reorder or add VGM filenames to the M3U, and run vgm_ren again to get the correct numbers in order.
You can't give multiple files to vgm_ren except by using a playlist: all but the first file will be ignored.
Renaming lone VGMs with an English Title tag
The new filename will be based on this tag field.
| Old Filename | New Filename |
|---|---|
| 09 Lively Lava, Spooky Cave_trimmed.vgz | Lively Lava, Spooky Cave.vgz |
| 9 89 Round 2-P.vgm | Round 2-P.vgm |
| dvo.vgm | Round 2-P.vgm |
Some characters are valid in Title tags, but not valid for filenames. These characters will be converted to the following replacements:
| In Title | In Filename |
|---|---|
" |
'
|
: |
-
|
? |
[removed] |
! |
[removed] |
/ |
,
|
\ |
,
|
| |
-
|
< |
(
|
> |
)
|
Spaces and dots (.) at the end of the filename before the .vgm or .vgz are removed also.
Title Screen/Palombie - Stage 1 becomes Title Screen, Palombie - Stage 1.vgz
Converting invalid characters is the only case where vgm_ren will use a filename with changes to the English Title. The tag itself is never changed by vgm_ren.
Renaming VGMs without an English Title tag
If you are making a pack/update to submit to VGMRips, you likely won't be using this form: Your VGMs will end up with English Title tags, and vgm_ren is best used then.
vgm_ren tries to avoid removing too much of the old filename. This will preserve dashes, underscores, and anything else that could legitimately be part of the name.
| Old Filename | New Filename |
|---|---|
| I Just Can't Wait to be King - Copy.vgm | I Just Can't Wait to be King.vgm |
| I Just - Can't- Wait to -be King - Copy.vgm | I Just - Can't- Wait to -be King - Copy.vgm |
| The Flyin' King - 01 - I Just Can't Wait to be King.vgm | The Flyin' King - 01 - I Just Can't Wait to be King.vgm |
| I Just Can't Wait to be King_trimmed_optimized.vgm | I Just Can't Wait to be King_trimmed_optimized.vgm |
| 04 84 1-1, 1-D, 1-M.vgm | 04 84 1-1, 1-D, 1-M.vgm |
Using and regenerating a playlist
For each track, vgm_ren will number it by its position in the .m3u playlist, and use the methods described above to create the rest of its filename. After renaming the VGMs, vgm_ren will also rewrite the M3U to use the filenames it generated.
If any files in the playlist are missing, they will be ignored and omitted from the rewritten M3U. If needed, you can re-add them and re-run vgm_ren.
The example outputs below use VGZs with English Title tags.
VGM or PlayList: "Joe & Mac.m3u" 04 - Rescue.vgz Error opening the file! 05 - Stage Clear.vgz Error opening the file! 06 - Stage BGM 2.vgz Error opening the file! 07 - Stage BGM 3.vgz Error opening the file! 08 - Boss Theme.vgz Error opening the file! 01 - Title Theme.vgz -> 01 Title Theme.vgz 02 - Introduction.vgz -> 02 Introduction.vgz 03 - Stage BGM 1.vgz -> 03 Stage BGM 1.vgz 09 - Ending Theme.vgz -> 04 Ending Theme.vgz Writing playlist ... Done.
By reordering the track lines inside the M3U, you can use vgm_ren to renumber/reorder the VGMs as many times as you need to:
VGM or PlayList: "Joe & Mac.m3u" 02 Introduction.vgz -> 01 Introduction.vgz 04 Ending Theme.vgz -> 02 Ending Theme.vgz 01 Title Theme.vgz -> 03 Title Theme.vgz 03 Stage BGM 1.vgz -> 04 Stage BGM 1.vgz