midi2agb

This is a reimplementation of Nintendo's mid2agb tool. It's not related to the original and is intended to fix a bunch of mid2agb's flaws. The state of bugs is now "reasonably stable". I did spend quite a bit of time on testing. If you still encounter any problems, please open up an issue or send me an e-mail.

These are the following things that it improves over the original mid2agb:

non proprietary software
auto optimizes the input MIDI to remove unnecessary events (removes trailing waits or waits with no events inbetween)
parses standard MIDI parameters correctly, like pitch bend range or expression
allows for various global song parameters to be set via meta events (like a modulation scale which often scales differently in MIDI software)
can apply a natural volume scale so the loudness has the same scale as your MIDI software

TODO:

The Pattern Detection currently works, but patterns aren't always used because the byte count comparison doesn't take the byte reduction by running state into account. The worst case of this is a song which is a couple of bytes larger than it should be.
Support weird AGB events like "memacc" or "xcmd".

Usage:

midi2agb [options] <input.mid> [<output.s>]

Option	Parameter	Default	Description
-s	symbol	file name	symbol name for the song header (address for the linker)
-m	volume	128	master volume for the song (0..128), 128=original
-g	voicegroup	voicegroup000	the default tone color set (aka voicegroup or soundbank)
-p	priority	0	priority of song for the music engine (0..127)
-r	reverb	0	enables song reverb if > 0 (0..127)
-n	-	disabled	enables natural volume scale to approximate MIDI like loudness
-v	-	disabled	enables debug output
--modt	value	0	0 = pitch modulation, 1 = volume modulation, 2 = panpot modulation
--modsc	value	1.0	scale the song's modulation by factor
--lfos	value	22	modulation speed: (value * 24 / 256) oscillations per beat
--lfodl	value	0	modulation delay after start of a note

MIDI Control Events

In order to access certain functionality of midi2agb and the sound engine's parameters, midi2agb treats certain MIDI Meta events specially:

Event	Format	Description
Marker, Text, or Cuepoint	`modt=?`	`?` sets GBA LFO type (0 = pitch, 1 = volume, 2 = pan)
Marker, Text, or Cuepoint	`modt_global=?`	same as `modt=?` but for all tracks
Marker, Text, or Cuepoint	`tune=?`	`?` sets GBA tuning (-64 .. +63, 1 semitone down .. 1 semitone up)
Marker, Text, or Cuepoint	`lfos=?`	`?` sets GBA LFO speed (? * 24 / 256 oscillations per beat)
Marker, Text, or Cuepoint	`lfos_global=?`	same as `lfos=?` but for all tracks
Marker, Text, or Cuepoint	`lfodl=?`	`?` sets GBA LFO delay (24 per quarter note)
Marker, Text, or Cuepoint	`lfodl_global=?`	same as `lfodl=?` but for all tracks
Marker, Text, or Cuepoint	`modscale_global=?`	Scale MIDI mod events by factor `?` (0.0 .. 16.0), useful to adjust for different intensity scales from other sources
Marker, Text, or Cuepoint	`[` or `loopStart`	sets the song's loop start position
Marker, Text, or Cuepoint	`]` or `loopEnd`	sets the song's loop end position
Marker, Text, or Cuepoint	`sym=?`	override command line `-s`
Marker, Text, or Cuepoint	`mvl=?`	override command line `-m`
Marker, Text, or Cuepoint	`vgr=?`	override command line `-g`
Marker, Text, or Cuepoint	`pri=?`	override command line `-p`
Marker, Text, or Cuepoint	`rev=?`	override command line `-r`
Marker, Text, or Cuepoint	`nat=?`	override command line `-n` (1 = enabled, 0 = disabled)

The classic mid2agb supports some of these features via special unused MIDI CCs. These are not supported since they are non standard and I found text meta events generally easier to insert with most MIDI software, so this is why I implemented it this way.

Binaries / Compiling:

The binaries in the "Releases" section might not be up to date. It's highly recommended to use the latest version from source for the latest bug fixes. When compiling from source, you'll also need cppmidi which is a git subrepo. Type "git submodule update --init" when trying to compile and it can't find cppmidi.

License

This tool is licensed under the MIT license. See the LICENSE file for details.

ipatix / midi2agb

readme