Manual

convert the input song into another format, saving it as file. Use --list-formats to see the available output formats.

list all the events in the song, in text form

list all the instruments used in the song, in text form

use a different instrument bank for subsequent conversions with --convert.

repeat the instrument bank until there are count instruments available. This is useful when replacing instruments, but there are not enough of them in the newly loaded bank.

show a list of supported file formats, along with the value to pass to --type, --convert and --newinst.

open the file as the given --type, even if it doesn't look like it's in that format.

force OPL2 mode (11 channels) when writing FM songs with --convert. This drops events that enable OPL3 mode.

force OPL3 mode (18 channels) when writing FM songs with --convert. This duplicates certain events so they apply to both register sets, and drops events that disable OPL3 mode. This may fail if the file format does not support OPL3 chips.

don't use pitchbends with --convert. This can make the output notes a bit cleaner if the song doesn't use any pitchbends.

print output suitable for parsing by a script.

manually specify the file type. The type is normally autodetected, but it needs to be specified for a few formats which lack signatures to identify them by. See --list-types.

list all the note on/off and other events in the Kiloblaster theme song.

convert the Duke Nukem II song hesbacka.imf into a CMF file saved as out.cmf. Because both IMF and CMF formats use Ad Lib/FM instruments, the instruments are converted as-is, with no replacement instrument bank required. Duke Nukem II however, plays its IMF songs at a different speed to the normal format, so the imf-idsoftware-duke2 file type must be manually specified to get the correct tempo.

convert the DOSBox Ad Lib capture capture.dro into a MIDI file called out.mid, using the instruments loaded from gm.mid.

Replacing the instruments is required here, because MIDI files cannot use Ad Lib instruments. The first instrument encountered in capture.dro is replaced with the first instrument used in gm.mid (which may not necessarily be MIDI instrument #1/piano.)