Music

Custom Background Music Tutorial

Tools & Files Needed

• Citric Composer - https://gota7.github.io/Citric-Composer/

• SequenceConvert - https://github.com/Gota7/SequenceConvert

• SDCafiine - https://github.com/wiiu-env/sdcafiine_plugin

• Unmodified cafe_barista_men.bfsar file

• Audio program for converting audio files to WAV format (Audacity works well)

⚠️ If you follow this tutorial please use SDCafiine as these modifications are a WIP and things might not be stable! ⚠️

Converting the audio you want to use for background music is pretty simple as all you need to convert the file to is a WAV Format (Keep in mind the size of the audio file as files that are too large simply won't work)

Image title

Next, launch Citric Composer and open your unmodified bfsar file.

Image title

Expand the Wave Archives drop down and double click [1]WARC_1_GUESS_GROUP_MEN

Image title

Scroll to the bottom of the archive and find [302] WAV_302_GUESS_BANK_MEN_BGM. Right click this file and select replace.
Choose your newly created WAV file you want to replace the current music with.
To add on to the size of files playing a role in whether or not this will work, you will want to replace all of the other existing BANK_MEN_BGM files with blank WAV files.
After you've replaced all of the relevant files, save the file (you are done with Wave Archives now).

Image title

Navigate to the Sound Sequences drop down and find BGM_MEN_TV. Right click the file and select export.
Now that you've exported the file you want to drag and drop the file over SequenceConvert.exe. This should create a new .fseq file that you can read and edit the values in a text editor of your choice.

Image title

There's quite a bit going on in this file, so I've provided an example file for this tutorial with some changes.
The sound file we replaced with our custom music is playing in SMF_Barista_Main_TV_Track_14_LoopStart. The two lines you will likely want to change (unless your music duration is the same as my example) are the two values after fn5. The first value is responsible for the volume of the audio and the second one changes the duration/fadeout time of the file. I still haven't figured out exactly what the units of the duration represent, so it might take some trial and error to get your audio looping how you want.

Image title

In the attached file I've provided it's important to note that the volume of the other unwanted audio files has been muted.
After you've made the changes you want, it's time to save this file and do the same process of dragging and dropping the file over SequenceConvert. Similarly, this should provide a new and updated BGM_MEN_TV.bfseq file that can replace the original one in Citric Composer.
Next, once the BGM_MEN_TV file is replaced I recommend changing the volume of BGM_MEN_TV_SYNTH to 0 as you most likely don't want the default idle music to play over the music you have chosen.

Image title

Finally, once you have gotten the files replaced it is time to save cafe_barista_men.bfsar.
To see if the changes you've made turned out the way you want, you can use SDCafiine to safely test any of the changes you've made without fear of any potential brick risk (similar to replacing men/men2 files for themes).
In order to add the modified music to an existing theme you will want to add a folder named "Sound" inside of your common folder. Inside of the Sound folder create another folder titled "Men". Lastly, place your updated cafe_barista_men.bfsar file in this new Men folder. Everything should be ready for testing, and if all went well you should have looping custom background music :)

Keep in mind that there are some issues with this as for whatever reason Citric Composer breaks some of the default menu sounds and I have yet to fix this. I'm sure this isn't that hard of an issue to deal with and it will likely be solved in the near future.

oh yeah here's the blank.wav almost forgot

Blank.wav

UPDATE: I've created a template file for adding music with the added menu sfx fix as well as gamepad music. The programs listed at the beginning of this thread are still necessary, although this template has already done a lot of the previous work for you.

As far as music goes, I recommend using the same output options in the image provided (must use WAV). With these settings I found for the maximum audio length to be around 1:55 before the file would be too large to work.

Image title

Once you have the audio converted to the correct format, open Citric Composer. Next, open the template BFSAR file. Expand the Wave Archives area and double click [1] WARC_1_GUESS_GROUP_MEN.

Scroll to the bottom of the window and find wave 302. Right click and replace this file with the audio file of your choice.

Image title

Save this window to update your changes. Now expand the Sound Sequences area.

The highlighted sequences (BGM_MEN_TV & BGM_MEN_DRC_MAIN) are what you will want to modify in order to get your audio looping properly.

Image title

Open the BGM_MEN_TV file and find "fn5 120, 1000".

To adjust the volume you can change the first value, 120, to be lower or higher. The second value, 1000 in this example, is the length of the audio that will play.

To calculate and update this value in order to match the length of your song you will want to take the number of seconds your song is and multiply that value with 192.

For example, a 1:55 song is 115 seconds, so you would multiply (115 * 192) in order to find the appropriate value.

Image title

The BGM_MEN_DRC_MAIN file is more or less the same as the other file, so you will want to make the same changes to this file as you did to the other. Having differences in audio length between these two files would cause music to not sync properly.

Image title

Once you have converted these .fseq files back to .bfseq format, you can now replace the existing files with your updated ones. Finally, save the file. Remember to rename the template BFSAR to "cafe_barista_men".

BFSAR Template (fixed sfx)

Made by dewgong:

cafe_barista_men (MII SFX)

Template with muted Mii sfx (music can be a bit longer as the Mii sounds take up a bit of space):

cafe_barista_men (NO MII SFX)

At 32khz, I found that the max length was 2:26 (stereo)

Archived

This is no longer needed

The patch provided already makes the music loop properly, and without any issues, this is here for archival purposes

Looping

Go back to the original window of Citric Composer
Double click Sound Sequences
Scroll until you find [371] BGM_MEN_TV and [372] BGM_MEN_DRC_MAIN
Right click [371] BGM_MEN_TV
Click Export
Save the BGM_MEN_TV.bfseq file on your device
Right click [372] BGM_MEN_DRC_MAIN
Click Export
Save the BGM_MEN_DRC_MAIN.bfseq file on your device

Don't close Citric Composer yet

We are not done using Citric Composer but we need to convert the files

Sequence Convert

Now we will use SequenceConvert

Drag BGM_MEN_TV.bfseq and drop it on SequenceConvert.exe
Drag BGM_MEN_DRC_MAIN.bfseq and drop it on SequenceConvert.exe

This will create the .fseq files we need

Open BGM_MEN_TV.fseq with the text editor of your choice

BGM_MEN_DRC_MAIN.bfseq

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;
; BGM_MEN_TV.fseq
;     Generated By Gota's Sound Tools
;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

SMF_Barista_Main_TV_Begin:
    alloctrack 57281
SMF_Barista_Main_TV_Start:
    timebase 96
    opentrack 14, SMF_Barista_Main_TV_Begin
SMF_Barista_Main_TV_Track_14:
    notewait_on
    prg 5
    volume 127
    pan 64
SMF_Barista_Main_TV_Track_14_LoopStart:
    fn5 120, 1000
    wait 100
    jump SMF_Barista_Main_TV_Begin
    fin

SMF_Barista_Main_TV_End:

You need to change the highlighted line 19: fn5 120, 1000

120 is the volume
1000 is the music length

To calculate and update the music length value in order to match the length of your song you will want to take the number of seconds your song is and multiply that value with 192.

Example

A 1:55 song has 115 seconds
Multiply 115 x 192
The result is 22080
In this example the music length value would be changed to fn5 120, 22080

Now save your changes

Now open BGM_MEN_DRC_MAIN.fseq with the text editor of your choice, the process is the same but if you want to see it click "Process" below

Process

BGM_MEN_DRC_MAIN.bfseq

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;
; BGM_MEN_DRC_MAIN.fseq
;     Generated By Gota's Sound Tools
;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

SMF_Barista_Main_DRC_Begin:
    alloctrack 15
SMF_Barista_Main_DRC_Start:
    timebase 96
    opentrack 1, SMF_Barista_Main_DRC_Begin
SMF_Barista_Main_DRC_Track_1:
    notewait_on
    prg 5
    volume 127
    pan 64
SMF_Barista_Main_DRC_Track_1_LoopStart:
    fn5 120, 1000
    wait 100
    jump SMF_Barista_Main_DRC_Begin
    fin

SMF_Barista_Main_DRC_End:

You need to change the highlighted line 19: fn5 120, 1000

120 is the volume
1000 is the music length

To calculate and update the music length value in order to match the length of your song you will want to take the number of seconds your song is and multiply that value with 192.

Example

A 1:55 song has 115 seconds
Multiply 115 x 192
The result is 22080
In this example the music length value would be changed to fn5 120, 22080

Now save your changes

Now that you have edited both BGM_MEN_TV.fseq and BGM_MEN_DRC_MAIN.fseq files

Drag BGM_MEN_TV.fseq and drop it on SequenceConvert.exe
Drag BGM_MEN_DRC_MAIN.fseq and drop it on SequenceConvert.exe

This will turn the .fseq files back to .bfseq

Replacing files

Go back to Citric Composer

Right click [371] BGM_MEN_TV
Click Replace
Replace with the BGM_MEN_TV.bfseq you just converted
Right click [372] BGM_MEN_DRC_MAIN
Click Replace
Replace with the BGM_MEN_DRC_MAIN.bfseq you just converted
Click File in the top left corner
Save