The Binding of Isaac: Rebirth

The Binding of Isaac: Rebirth

Soundtrack Menu
☢ Nato Potato ☢  [developer] 10 Jul, 2024 @ 10:14pm
Repentogon Exclusive Features
Thanks to callbacks added by Repentogon you can now set custom music for the main menu, the run start jingles and the pre-level nightmare while in game.

To change the main menu music and run start jingle settings go through the main soundtrack selection and go left past the "Jingles only" mode (or right past all your installed soundtracks), once you've updated the settings then just change the soundtrack selection back to whatever soundtrack you want to use in game play.

The options in the main menu section allow you to select a soundtrack and tracktype to play while in the menu, apart from the soundtracks you have installed the soundtrack option can also be set to:
"Silent" - play nothing
"Random" - pick a random soundtrack from your list
and "Use last played soundtrack" - use whichever soundtrack was being played before you quit/died/finished a run, or the default soundtrack on initial game load, good if you usually use shuffle mode

Other than the regular track types the track option can be set to:
"Random" - pick a random track type
"Random Floor" - pick a random floor track (e.g. basement, cellar, depths, etc)
"Random Room" - pick a random room track (e.g. shop, secret room, library, etc)
"Random Boss" - pick a random boss track (e.g. mom, satan, hush, etc)
and "Main Menu" - use the 'Main Menu' track from the selected soundtrack, or the 'Arcade Room' music if the soundtrack doesn't have a 'Main Menu' track set

There are separate selection options for the tainted menu, if 'Main Menu' is selected for the tainted menu and the track has the 'twisted' layer (see below) the twisted version will be used.


These tracks can be included in a soundtracks music.xml with titles matching this format:
SOUNDTRACKNAME Main Menu
SOUNDTRACKNAME Run Start
SOUNDTRACKNAME Tainted Run Start
SOUNDTRACKNAME Nightmare
SOUNDTRACKNAME Dogma Nightmare

if you want to have an alternate 'Twisted' menu theme for when it's in tainted mode you can include it as a layer in the Main Menu track, e.g.
<track name="Soundtrack Main Menu" intro="Normal Menu Intro.ogg" path="Normal Menu.ogg" layerintro="Twisted Menu Intro.ogg" layer="Twisted Menu.ogg" loop="true" layermode="2" layerfadespeed="0.01" />
Make sure to include the layermode="2" and layerfadespeed="0.01" settings.
The intro and layerintro settings aren't necessary if neither version of the menu music has a separate intro file.
Also note that the twisted version of the menu theme won't play at the title screen or file select, only while in a specific game file.


Continuous floor music can now be supported for all soundtracks, this can be enabled in the options section of the soundtrack menus config page, it works by playing the room music as a 'jingle' and silencing the regular music, so unfortunately leaving and re-entering a room will restart the rooms music and if you enter a room while a jingle is playing it will get cut off by the rooms music, but otherwise it should work as you would expect.


Another benefit of repentogon (aside from more reliable music control) is that all soundtracks now support having jingles that don't stop the floor music, regardless of whether or not they had sfx jingles set up, it is just supported for all soundtracks by default now.
Last edited by ☢ Nato Potato ☢; 12 Jan @ 5:13pm