x68k_vgm2mml

This tool extracts performance information such as notes, note lengths, volume, and timbres from register operations recorded in VGM, and generates structured MML for X68000 (for MDX) and PCM IR. Requires Python 3.10 or later.

Usage

Generate MML and PCM IR by specifying a VGM file

# Generate MML only
python vgm2mml.py INPUT.vgm --outdir OUTDIR

If you want to automatically perform everything from MML generation through MDX generation, use scripts/export_mdx.py (described below).

Batch convert a directory containing VGM files to MML, PCM IR, and MDX/PDX

Specify the directory containing the VGM files to convert them in batch.

# Automatically converts not only to MML but also through to MDX/PDX.
python scripts/export_mdx.py INDIR --outdir OUTDIR --force

By default, the VGM’s whole-song loop is not used, and an MDX that ends after one pass is generated (to help large songs fit within the limits). To render the VGM’s whole-song loop as a second pass with saved state:

python scripts/export_mdx.py INDIR --outdir OUTDIR --force --vgm-song-loop

Generating MDX requires an MDX compiler such as MXC or mmlx. PDX…