TWiLight Menu++

DSi/3DS Skins - Custom SFX

TWiLight Menu++ supports custom sound files in themes. Place your sound files under the sound subdirectory in your theme folder, for example for the white theme, you would place the files at themes/white/sound/sfx.bin and themes/white/sound/bgm.pcm.raw respectively. Both files are optional, if bmg.pcm.raw is missing, the default music will be used. The same thing would happen with the sound effects if sfx.bin is missing as well.

These instructions assume you have devkitPro installed with mmutil. You can get devkitPro at the devkitPro website.

Sound Effect Bank #

The sound effect bank (sfx.bin) contains sound effects such as the icon select sound, etc.

File Description
startup.wav Played on startup. See the section on Startup sound for more details
back.wav Back
launch.wav Played when launching a game
select.wav Played when moving the cursor in the per-game settings and select menu
wrong.wav Played when reaching the end of the page
switch.wav Played when switching pages
stop.wav Played on the DSi Theme when the select cursor stops moving

All the files listed above are required to build a custom sound effect bank. If you want a sound to be mute, you can use a silent audio file. The .wav format is mandatory and the encoding must be PCM.

This file includes the sounds used in the default DSi and 3DS themes, along with the makefile used to build them into a valid sfx.bin file. Feel free to edit and change the sound files to make a custom sound effect bank.

To build your custom sound effect bank, open your terminal (or command line if you are using Windows), change the current directory (cd) to the folder where Makefile is, and then run the make command. You will get a resulting sfx.bin file that can be copied to the sound subfolder in your theme folder. This file must be under 512000B = 512 kB. Any file larger than that will result in either crashes or some sounds not playing fully.

Startup sound #

While the other sound effects will work with any WAV file with PCM encoding, the startup sound must be in a specific format in order to work properly, otherwise there will be a gap between when the startup sound stops and the background music begins.

The startup.wav file must be 16-bit 16 kHz. You can use Audacity for example to convert to this format. Once the file is loaded in Audacity, change the Project Rate (Hz) to 16000, then press Shift+M, and change the Format to 16-bit PCM.

If your file is in Stereo, you should also go to Tracks > Mix > Mix Stereo down to Mono.

You must set PlayStartupJingle=1 in your theme.ini for the startup jingle to play.

Menu BGM needs to be a 16-bit Mono .wav file. Below is the method for converting audio files into that format.

Unlike sfx.bin, bgm.wav can be arbitrarily large.

Please note that if your audio file already comes as a .wav file, you must follow the below method anyways, as TWLMenu++ has specific requirements.

Audacity #

To get started, download the latest version of Audacity.

To convert the audio:

  1. Load the file in Audacity
  2. If your file is in stereo, click on the song then select Tracks > Mix > Mix Stereo down to Mono
  3. Go to Audio Setup > Audio Settings..., and make sure the Project Sample Rate is not set to be above 48000 Hz (which is the limit)

To export in the correct format:

  1. Select File > Export > Export Audio...
  2. Set Save as type to WAV (Microsoft)
  3. Set Encoding to Signed 16-bit PCM
  4. Set the output name to bgm.wav and click Save
  5. Click Clear and then click OK to the metadata editing

Now you have a bgm.wav file that can be copied to the sound subfolder in your theme folder.

You should then set the DSi/3DS Theme Music option in TWiLight Menu++ settings to “Theme” for your custom BGM to play on the menu.