GBAMusRiper is a tool capable of ripping music from '[[GameBoy Advance] (GBA) games developed with the m4a (aka AGB MusicPlayer2000 or Sappy) sound engine. A non exhaustive list of such games is available on '[l[https://www.caitsith2.com/gsf/ofslist.txt[this page].

It returns midi (.mid) and sound font 2.0 (.sf2) files. Samples can be extracted from the later using an external application.

Although it is a Windows program, it can also be used on Linux with Wine.

'[#[Capabilities]
A detailed list of features is available in the documentation. See the file called reame.txt.

It is worth to notice that GBAMusRiper will only work with games that used m4a as their sound engine. 


'[#[Quick set up]
Download GBAMusRiper from its '[l[https://www.romhacking.net/utilities/881/[Romhacking.net page].

'[t[b3]Usage'[/t]
For this part, you will need a GBA ROM. 

'[t[b2] Extracting midi and sound font files '[/t]
In the GBAMusRiper files, search for a program called gba_mus_riper.exe. You simply have to use this program with your GBA ROM. This can be done in two different ways.

'[t[b1] From the File Explorer (Windows only) '[/t]
Drag and drop your GBA ROM on the gba_mus_riper.exe file. This will open a console prompt, wait for it to finish (this can be a bit long).

'[t[b1] From the command line '[/t]
Use this command:
'[c]gba_mus_riper.exe my_gba_rom.gba'[/c]

When gba_mus_riper.exe is done, you will obtain a folder containing:
'[ul['[li[a sound font file (.sf2): it's were are all the sample data.]'[li[a bunch of midi files (.midi): each file contains the pattern data of a track. They are used combined to the sound font to produce the music from your GBA game.]]You can play midi files using for instance VLC, this will need a bit of set up as explained '[l[https://wiki.videolan.org/Midi/[here]. More information about midi is available on the '[[midi (format)] lyceum page.


'[t[b2]Extracting samples from the sound font (.sf2) file '[/t]
You can do it by using the application '[l[https://www.polyphone.io/en/software[Polyphone], available on Windows, macOS and Linux.

Open the sound font file from Polyphone. Click on the arrow on the sample tab. This will show you all the samples contained in the .sf2 file. Select as many samples as you want, then click on the toolbox (you will find it in the app toolbar). You should find an option called "Wav export...".


'[#[Links for further development]
GBAMusRiper was originally created by Romhacking user Bregalad. The last release is from 2016, the sources are available on the '[l[https://www.romhacking.net/utilities/881/[Romhacking page] dedicated to GBAMusRiper.

A newer fork is available '[l[https://github.com/berg8793/gba-mus-ripper[on GitHub], it was last updated in 2020.

'[#[See also]
All related Lyceum articles:
referencing to: 
- '[[GameBoy Advance]
- '[[midi (format)]
referenced from:
- '[[GameBoy Advance]