mirror of
https://github.com/rvtr/wiki.git
synced 2025-10-31 06:31:13 -04:00
68 lines
4.9 KiB
Markdown
68 lines
4.9 KiB
Markdown
---
|
||
lang: uk-UA
|
||
layout: wiki
|
||
section: twilightmenu
|
||
category: customization
|
||
title: DSi/3DS скіни - Користувацькі ефекти
|
||
description: Як використовувати користувацьку фонову музику та звукові ефекти у скінах DSi та 3DS для TWiLight Menu++
|
||
---
|
||
|
||
TWiLight Menu++ підтримує користувацькі звукові файли в темах. 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](https://devkitpro.org/wiki/Getting_Started).
|
||
|
||
## Sound Effect Bank
|
||
The sound effect bank (`sfx.bin`) contains sound effects such as the icon select sound, etc.
|
||
|
||
| File | Опис |
|
||
| ----------- | -------------------------------------------------------------------------------------- |
|
||
| startup.wav | Played on startup. See the section on [Startup sound](#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](/assets/files/sfx-example.zip) 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](https://github.com/audacity/audacity/releases/latest) 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
|
||
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](https://github.com/audacity/audacity/releases/latest).
|
||
|
||
To convert the audio:
|
||
1. Load the file in Audacity
|
||
1. If your file is in stereo, click on the song then select `Tracks` > `Mix` > `Mix Stereo down to Mono`
|
||
1. 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...`
|
||
1. Set `Save as type` to `WAV (Microsoft)`
|
||
1. Set `Encoding` to `Signed 16-bit PCM`
|
||
1. Set the output name to `bgm.wav` and click `Save`
|
||
1. 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.
|