TWiLight Menu++

TWiLight Menu++
General
Author	DS-Homebrew
Type	Title Launchers
Version	25.10.0
License	GPL-3.0
Last Updated	2023/06/06
Links
Download
Website
Source

TWiLight Menu++ is an open-source DSi Menu upgrade/replacement for the Nintendo DSi, the Nintendo 3DS, and Nintendo DS flashcards. It can launch Nintendo DS, SNES, NES, GameBoy (Color), GameBoy Advance, Sega GameGear/Master System & Mega Drive/Genesis ROMs, as well as DSTWO plugins (if you use a DSTWO) and videos.

Features

• Launch DS, DS, and DS Ware ROMs from the SD card and/or flashcard, via nds-bootstrap (comes included with the app).
• For flashcards, the flashcard kernel/firmware can optionally be used to boot the games, but only for regular DS games, and DS⁽ⁱ⁾-Enhanced games in DS mode.
• Automatic on-the-fly AP-patching! Drag and drop your ROMs onto the SD card, and play, without any additional steps.
• The included AP-patches are loaded for a specific game, by nds-bootstrap, and the patching is done in RAM, leaving your original ROM untouched.
• Bring the DSi Menu to your DS Phat/lite, by putting TWLMenu++ on a flashcard.
• First DS flashcard UI to show animated icons from DS-Enhanced, DS-Exclusive, and DS Ware games.
• Set the language to your preference.
• 10 save slots for DS games.
• For DSi/3DS/2DS users: Overclock your DS games to 133mhz, faster than normal DS clock speed of 67mhz.
• For DSi/3DS/2DS users: Change sound frequency from 32kHz to 48kHz for higher sound quality.
• Directly access the flashcard's microSD card, and switch to and from there anytime (Only applies to compatible flashcards).
• Run the last played ROM on TWiLight Menu++ startup.
• Play retro games from these consoles:
  • Atari XEGS, via XEGS-DS (.xex and .atr).
  • Atari 2600, via StellaDS (.a26 only).
  • Atari 5200, via A5200DS (.a52 only).
  • Atari 7800, via A7800DS (.a78 only).
  • NES/Famicom, via nesDS.
  • (Super) GameBoy (Color), via GameYob.
  • Sega Master System/Game Gear, via S8DS.
  • Sega MegaDrive/Genesis, via jEnesisDS (or PicoDriveTWL, if ROM is above 3MB) (.gen only).
  • Super Nintendo/Famicom, via SNEmulDS.
  • PC-Engine/TurboGrafx-16, via NitroGrafx.
  • GameBoy Advance, via GBARunner2 or the DS' native GBA mode, which the latter requires one of these Slot-2 flashcards:
    • M3.
    • G6.
    • SuperCard SD/MiniSD/MicroSD.
    • EZ-Flash (before Omega) (Saving does not work).
• Play videos: Using GBARunner2 or native GBA mode.
• 3DS/2DS users: Play DS games in 16:10 widescreen! Not all games will work with this feature.

Installation

• How to install on 3DS, DSi and Flashcard.
• How to update on 3DS, DSi and Flashcard.

Release includes nds-bootstrap.

User guide

Useful links

• TWiLight Menu++ DS Compatability List.
• TwiLight Menu++ official website.
• Tutorials from CFWaifu.
• TwilightBoxart (Box Art downloader for TWL++ by KirovAir) and Manual.
• Homebrew Video Players for the Nintendo DS(i).

Emulators on the DS/DSi

Below is the list of emulators and loaders that have been bundled into TWiLight Menu++ (in /_nds/TWiLightMenu/emulators/). They can be run on DS/DSi/3DS (in DS/DSi mode).

Format	Loader	Extensions	Save file
ARGV1	Native	.argv
Atari 2600	StellaDS	.a26
Atari 5200	A5200DS	.a52
Atari 7800	A7800DS	.a78
Atari XEGS	A8DS (XEGS-DS)	.xex, .atr
ColecoVision	S8DS, ColecoDS	.col
DS	nds-bootstrap, flashcard kernel, native	.nds, .dsi, .ids, .srl, .app	saves/[rom name].sav2
DSiWare	Unlaunch, nds-bootstrap	.nds, .dsi, .ids, .srl, .app	saves/[rom name].pub, saves/[rom name].prv
DSTWO Plugin	DSTWO3	.plg
Game Boy (Color)	GameYob DS	.gb, .sgb, .gbc	[rom name].sav
Game Boy Advance	GBARunner24, native5	.agb, .gba, .mb	[rom name].sav
Game Gear	S8DS	.gg	[rom name].gg.sav
Genesis/Mega Drive	jEnesisDS, PicoDriveTWL	.gen	[rom name].srm6
Intellivision	Nintellivision	.int
Master System	S8DS	.sms	[rom name].sms.sav
Neo Geo Pocket (Color)	NGPDS	.ngp, .ngc	/data/ngpds/[rom name].ngp.fla
Fast Video	Coming Soon	.fv
NES/Famicom	nesDS	.nes, .fds	[rom name].sav
PC Engine/TurboGrafx-16	NitroGrafx	.pce
Rocket Video	Rocket Video Player	.rvid
SG-1000	S8DS, ColecoDS	.sg
Sord M5	ColecoDS	.m5
SNES	SNEmulDS	.smc, .sfc	[rom name].srm
WonderSwan (Color)	NitroSwan	.ws, .wsc	???

1. Text files containing the path to a DS homebrew app and arguments to launch it with, see nds-hb-menu’s README for more info
2. Only for retail ROMs, homebrew do not have specific save files
3. Only works from a SuperCard DSTWO flashcard as it has additional processing power and RAM inside the flashcard
4. When running in DSi Mode, it can use the DSP for better sound
5. Requires a Slot-2 flashcart and thus only works on DS Phat and DS Lite
6. jEnesis can only save when running from a flashcard, but PicoDriveTWL can save from SD and flashcard

Notes on specific emulators

RAM Disks:

• In order for jEnesisDS, neoDS and SNEmulDS to work on the DSi SD card, you’ll have to use a RAM disk with nds-bootstrap.
• RAM disk makers exist for jEnesisDS & SNEmulDS and are built into TWiLight Menu++. You will need to create your own RAM disk for neoDS. See Creating RAM Disks on how to do so.
• The reason why RAM disks are used is because these emulators, ARM7 hooks don’t work properly.

Comparison between PicoDriveTWL and jEnesisDS:

PicoDriveTWL	jEnesisDS
Made for DSi.	Made for DS.
Does not require RAM Disks.	Require RAM Disks.
Support saving on DSi SD cards, quicker loading time.	Does not support saving on DSi SD cards.
Support arguments.	Does not support arguments.
2.5MB limit on Flashcard (can use DSi extra RAM & DS Memory Pak).	3MB limit on all platforms.
No sound.	With sound emulation.
Extremely choppy.	Smooth framerate.

FAQ

Q. How do I fix getting a white screen when booting TWiLight Menu++?

First, try putting the console in sleep mode (e.g. closing the console’s lid, or pressing the sleep button on the O2DS), then wake up the console from it.

If that doesn’t work, format your SD card to FAT32 with 32 KB cluster/allocation size.

If that also doesn’t work, try a different SD card.

Q. Where is the Acekard/Wood UI theme?

The acekard (also called Wood UI) theme was removed due to its buggy behaviour and causing SD Card corruption. Please wait for a fix.

Progress for the return of this theme can be found in this PR.

Q. How do I fix TWiLight Menu++ restarting or giving a Guru Meditation Error when launching a game?

Go into TWLMenu++ Settings, and disable Update recently played list.

Q. Why do I get a white screen when trying to load a game from SD card?

First, check the nds-bootstrap compatibility list and make sure your game is compatible.

Try with all cheats disabled for that game as some cheats are not compatible with nds-bootstrap at the moment, you can use L to disable all cheats for a game.

If it worked before, delete the fatTable and patchOffsetCache folders in sd:/_nds/nds-bootstrap/

Q. How do I use cheats?

You need to have a cheat DB in the form of a usrcheat.dat file in the sd:/_nds/TWiLightMenu/extras/ folder.

The most updated cheat database is DeadSkullzJr’s.

On the 3DS, this database is available in the Universal-Updater app as NDS Cheat Databases. This will automatically install it to the required location.

Alternatively, you can use r4cce to create your own cheat DB.

Q. How do I show a custom picture on the top screen of the DSi theme?

A random .png image in sd:/_nds/TWiLightMenu/dsimenu/photos/ will be shown each time the menu is loaded.

The images(s) must be no bigger than 208x156.

If you have errors, it’s most likely an error with the image size. Please use tinypng to reduce the size.

Q. How do I get games?

You can download homebrew games from Universal-DB and GameBrew. To get dumps of your retail games:

• On DS you can use GodMode9i to dump your GBA games and, if you have a Slot-2 flashcard, DS games.
• On DSi you can use GodMode9i to dump your DS games and DSiWare.
• On 3DS you can use GodMode9 to dump your DS games, DSiWare, and Virtual Console titles.

Q. Can I get the save files from my game cards onto my SD card or vice versa?

Yes, you can use GodMode9i on DSi and 3DS or Checkpoint on 3DS.

Q. How do I change TWiLight Menu++’s language?

Open TWiLight Menu++ settings, you can do this by holding SELECT while loading TWiLight Menu++.

Press L or Y once (on flashcard/3DS) or twice (on DSi). Change the first option until you see the language you want, then exit settings.

You may also want to change the next two options as they control the language of DS games and their titles in TWiLight Menu++.

Q. Is this a DS(i) emulator?

No, this is not an emulator. The menu and DS games (loaded via nds-bootstrap) are ran natively in the console’s DS/DSi mode.

The only consoles emulated are the past consoles, but partially for GBA (as some or all parts like graphics are ran natively).

Q. Why isn’t touch input working on sudokuhax?

Depending on the save file of sudokuhax, the touch screen inputs may not work.

Q. Can The Biggest Loser boot TWiLight Menu++?

No. As The Biggest Loser is a Slot-1 game, and not a DSiWare game, SD access is disabled when running Slot-1 cards.

Controls

DSi, 3DS, SEGA Saturn, Homebrew Launcher themes:

Left/Right - Select a game/app

A/Start - Launch game/app

L/R/Select+Left/Right - Switch pages

Select+Up/Down, then release Select (DSi/Saturn/HBL theme) - Switch between SD card and flashcard

X - Delete/hide game

Y - Per-game settings

Select (DSi/Saturn/HBL theme) - The Select menu or DS Classic Menu (Where system menu, TWiLight Menu++ Settings, and GBA Mode can be accessed)

Per-game setting:

X - Cheat menu

A - Toggle cheat (in cheat menu)

B - Exit cheat menu (in cheat menu)

X - Save and exit cheat menu (in cheat menu)

Y - Show cheat description (in cheat menu)

L - Disable all cheats (in cheat menu)

R4 theme:

Up/Down - Select a game/app

A - Launch game/app

L - Switch between the SD card and flashcard

Y - Per-game settings

Per-game setting:

X - Cheat menu

A - Toggle cheat (in cheat menu)

B - Exit cheat menu (in cheat menu)

X - Save and exit cheat menu (in cheat menu)

Y - Show cheat description (in cheat menu)

L - Disable all cheats (in cheat menu)

Boot shortcuts:

These should be pressed on the TWiLight Menu++ splash screen/right after the Nintendo DSi splash screen.

Select - Open settings

A+B+X+Y - Reset all TWiLight Menu++ settings

B - Boot the last ran ROM

Media

SRLoader (now TWiLight Menu++) - DS and (S)GB(C) from SD Card on DSi (Rojelio Reyes)

TWiLight Menu++ (23.1) | Nintendo DS Lite | DSi Games on DS (Stranno)

Changelog

v25.10.0

• What's new?
  • @DeadSkullzJr: Added AP-fixes for some Pokémon ROM hacks.
    • Pokémon: Legacy - Sevii Islands (Demo v1.2)
    • Pokémon: Blaze Black Version (v3.2)
    • Pokémon: Blaze Black Version 2 (v1.2)
    • Pokémon: Volt White Version (v3.2)
    • Pokémon: Volt White Version 2 (v1.2)
    • Pokémon: Pitch Black Version (v1.3)
    • Pokémon: Pure White Version (v1.3)
    • Pokémon: Special Adventures Edition (v1.3)
    • Pokémon: Yin Black Version 2 (v1.1)
    • Pokémon: Yang White Version 2 (v1.1)
• Improvement
  • @lifehackerhansol: Updated DLDI submodule.
    • Cheats have been confirmed to work on DSTT-based flashcards via nds-bootstrap.
• Bug fix
  • @lifehackerhansol: Fixed autoboot for timebombed flashcards.

v25.9.6

• What's new?
  • To fully restore the look of the DSi Menu, the default fallback skin for the DSi theme is now the light skin instead of the dark one.
    • This was done because of some users apparently having bad first impressions with TWLMenu++ on DSi, and in addition, would end up making forwarders for the original DSi Menu (along with optionally installing hiyaCFW, a DSi CFW which is not needed nowadays).
    • You can still download the dark skin here: https://skins.ds-homebrew.com/nintendo-dsi/default-dark
      • In the dark.7z file, put the dark folder in sd:/_nds/TWiLightMenu/dsimenu/themes/, then open TWLMenu++ Settings, select Theme (set to Nintendo DSi), press A, then select dark.
• Improvement
  • @lifehackerhansol: Updated GMP-Z003 autoboot to flashcard-bootstrap v1.2.3, with an open-source DLDI.
• Bug fix
  • Fixed the DS/DSi splash jingle not playing and either no or glitched sound playing in place.

v25.9.5

• What's new?
  • Added a working AP-fix for The Legend of Zelda: Spirit Tracks (Europe, Rev 1)!
    • The fix comes from @DeadSkullzJr's cheat database.
• Improvement
  • @lifehackerhansol: Updated some DLDI drivers.
• Bug fix
  • Fixed a possible bug where a game wouldn't boot if it's placed on the SD root.

v25.9.4

• Now applies to DS Classic Menu as well: Fixed an overlooked bug which made games not start.
  • For DS(i) games, nds-bootstrap would either display error code -2 or white screens after launching a game.

v25.9.3

• Fixed an overlooked bug which made games not start.
  • For DS(i) games, nds-bootstrap would either display error code -2 or white screens after launching a game.

v25.9.2

• Fixed white screen appearing on the top screen, if music is turned off.
• Fixed text flickering in TWLMenu++ Settings with Memory Expansion Pak inserted.
• Changed Use nds-bootstrap to Game Loader in the per-game settings menu to reflect the change in TWLMenu++ Settings.

v25.9.1a

• Bug fix
  • Fixed to no longer show white screens on boot (unless there's an actual SD or libfat issue).

v25.9.0
What's new?

• @DeadSkullzJr: Added AP-fix for Pokémon: SoothingSilver Version (v1.3.0)
• @DeadSkullzJr: Added AP-fix for Pokemon: StormSilver Version (v1.10)
• @icup321: Added Rayman Raving Rabbids widescreen patch (#2169)
• To recreate the look and feel more closely, the DSi & 3DS themes now fade in after loading the current page of games.
• Increased file/folder limit from 320 to 512 (Flashcard) or 1024 (DSi/3DS).
• @PW5190: Added ESRB Ratings for more DS games (#2175)
• Changed the Use nds-bootstrap setting to Game Loader on flashcards.
  • Default setting is nds-bootstrap.

Improvement

• @Epicpkmn11 and various: Updated translations.

Bug fixes

• To prevent some weird issues, TWLMenu++ no longer boots with a write-locked SD card.
• argv is no longer passed to Unlaunch.dsi, in hopes of fixing the bug where it doesn't boot for certain users.
• Fixed sd:/hiya.dsi not being detected, for when trying to open System Settings or the DSi Menu.
• Fixed DSiWare launched from flashcard not booting via nds-bootstrap when copied to a temp location on the SD card.
• @DieGo367: Fixed custom icons/banners on argv files (#2166, #2167)
• Fixed a long-standing bug where launching Pictochat or DLP using the DS Classic Menu doesn't work sometimes.
• @DieGo367: Added bounds checks for datetime/username font draws (#2173)
• @DieGo367: Fixed font-related crash (#2163)
• If an invalid user/favorite color is detected in the FW chip, it now defaults to gray (or red for the TWLMenu++ splash screen).
• Switched back to the FastVideoDSPlayer build with TWL WRAM check to allow video playback when using Memory Pit.

v25.8.1

• Improvement
  • @Epicpkmn11 and various: Updated translations.
• Bug fix
  • Fixed error message not appearing when launching via flashcard loader fails.
  • @lifehackerhansol: Added missed INI setting for RTS-compatible flashcard loaders.

v25.8.0

• What's new?
  • The new Digimon Story: Lost Evolution English translation is now AP-fixed instead of the old one.
  • Corrected AP-fix for Alice in Wonderland (Europe).
    • Does not fix the AP issue.
  • @DieGo367: Allow setting custom color palettes based on user profile color for all paletted graphics (#2137)
  • @Epicpkmn11: Allow making the loading screen dark (#2134)
  • @Epicpkmn11: Added option to disable alpha blending (#2141)
  • @Epicpkmn11: Improved in-game menu hotkey setting menu (#2127)
  • DSi/3DS: Added feature to swap SD cards before TWLMenu++ starts, by holding Right + A.
    • Useful if Unlaunch cannot display TWLMenu++ (as boot.nds), despite the SD card being formatted properly, and if you have another SD card which Unlaunch can display the boot.nds file just fine.
  • @lifehackerhansol: Added M3i Zero (GMP-Z003) autoboot (#2138)
• Improvement
  • @lifehackerhansol: Switched to open-source Ace3DS+ DLDI.

v25.7.0

• What's new?
  • When started via flashcard, in order to use the settings from the console's SD card slot, a file called primary must now be created in sd:/_nds/.
  • @quiple: Updated font used in the DS Classic Menu.
  • Updated AP-fix for Anpanman to Touch de Waku Waku Training in order to work properly with nds-bootstrap v0.68.0.
  • Finally updated NitroGrafx to v0.9.0.
  • Support for the EZ-Flash RAM is now disabled by default.
    • In order to use it again, EZ_FLASH_RAM must be set to 1 in fat:/_nds/TWiLightMenu/settings.ini.
• Improvement
  • @Epicpkmn11 and various: Updated translations.
• Bug fixes*
  • Fixed games not booting in widescreen, as well as all of DS(i) mode being stuck in widescreen after launching a game with widescreen.
    • If you've been affected by this bug prior to this version, delete TwlBg.cxi in sd:/luma/sysmodules/, and re-follow the widescreen guide.
    • This also fixes games from the console SD not booting after the flashcard is mounted via SCFG access.
  • Fixed white screen crash caused by hiyaCFW (again).
    • Will not be reverted due to inevitable bugs related to NAND init/read code.

v25.6.01

• Fixed an overlooked bug which caused TWLMenu++ to not start via Memory Pit and/or when exiting from homebrew.

v25.6.0

• What's new?
  • The first 32KB of both the arm9 & arm7 DSi BIOS are now dumped to sd:/_nds/ for use by nds-bootstrap.
  • TWiLight Menu++ is no longer required to be installed on your flashcard in order to access it's contents from DSi/3DS SD card with unlocked SCFG!
  • It may still need to be installed there in order to run some retro games from the flashcard.
• Improvements
  • Mr. Start: The Super Nintendo DS splash screen (only viewable with Slot-2 flashcards which aren't EZ-Flash) has been updated!
  • @Epicpkmn11 and various: Updated translations.
• Bug fixes
  • @Epicpkmn11: WAV header is now used for converted ADPCM music, in order to fix where the sample rate is wrong on second play of the music.
  • The last 16KB of the DSi WRAM is no longer cleared in order for dsibiosdumper to work correctly.
  • Fixed the SD removal check being tripped in DS Classic Menu (the result of the black screens with white text) depending on how much RAM is used.
  • Fixed Slot-1 or some flashcards not booting with Slot-1 microSD access turned off.

v25.5.0

• What's new?
  • Updated halloween splash BG to add a jack-o-lantern pumpkin face!
  • Added Super Nintendo DS logo for if a Slot-2 flashcard is detected!
  • Added Kiosk mode, which disables access to any settings menu, and the hiding and deletion of titles.
  • Can only be enabled in sd:/_nds/TWiLightMenu/settings.ini by setting KIOSK_MODE to 1.
  • If the console screens go black when starting via Unlaunch, sleep mode can now be disabled by setting SLEEP_MODE to 0 in sd:/_nds/TWiLightMenu/settings.ini.
  • @SNBeast & @Epicpkmn11: Added new Unlaunch Launcher patch! (#2070)
• Improvement
  • @Epicpkmn11 and various: Updated translations.
• Bug fix
  • @Epicpkmn11: Restored alpha blending to top screen fonts in DSi-based themes.

v25.4.0

• What's new?
  • FastVideoDSPlayer (by @Gericom) is now bundled! Play videos as high as 60FPS on DSi, 30FPS on DS, and with any length!
    • See this page for more information, as well as how to convert a video.
  • Added logging! Open sd:/_nds/TWiLightMenu/log.txt to see what TWLMenu++ has printed out while it was running a certain theme.
    • Only very minimal information is printed out for now.
  • nds-bootstrap pre-load settings are now bundled!
  • @Epicpkmn11: Added extension blocking INI-only setting. (#2061)
  • Box art is now turned off by default for first-time users.
• Improvement
  • @Epicpkmn11 and various: Improved translations.
• Bug fixes
  • Fixes a bug which caused DSi-based themes to crash on white screens during font loading, when running on CycloDS iEvolution in DSi mode.
  • DSiWare booter per-game setting is no longer ignored when booting Last-run ROM.
  • Fixed where pressing A, X, or Y would not work in DSi-based themes with box art turned off, if Left or Right aren't pressed on D-Pad.
  • Loading screen is no longer shown when skipping to the end of a page in DSi-based themes.
  • Fixed touch frame delay.

v25.3.1

• What's new?
  • Added Kirby Super Star Ultra menu softlock fix. (Code by @DeadSkullzJr)
  • Cluster size warning is now shown for DSiWare on flashcards.
• Improvements
  • @Epicpkmn11: DSi/R4 themes: Hidden file check is now faster. (#2035)
  • Other minor improvements.
• Bug fix
  • Fixed screen tearing before displaying box art.

v25.3.0: Labor Day Release

• What's new?
  • @DieGo367: DSi Theme: Added macro-specific backgrounds (#2004)
  • Due to some requests, the long version of the TWLMenu++ splash jingle has been re-added as an optional setting.
• Improvements
  • @Epicpkmn11 and various: Updated translations and added Ryukyuan language.
  • The TWLMenu++ splash screen now plays with no jitter on DS consoles from flashcard, and DSi consoles from SD card.
• Bug fixes
  • @lifehackerhansol: Switched to open-source M3DS Real DLDI, fixing compatibility with nds-bootstrap's B4DS mode.
  • @lifehackerhansol: Switched to open-source EZ-Flash V DLDI.
  • Fixed manual not opening in 3DS theme on flashcards.
  • Fixed the SD/Slot-1 icon not displaying on flashcards running with the SD/SCFG access settings.
  • @Epicpkmn11: Fix residual text when printing small characters (#2012)
  • @DieGo367: Some top text printing fixes (#2018)
  • Other minor fixes.

v25.2.1

Bug fix

• Fixed Async Card Read not showing in the per-game settings menu, if it's opened for a TWL ROM which can pre-load into RAM in DS mode on DSi consoles.

v25.2.0: TWL Summer Release #7

What's new?

• The DS firmware proto version of the GBA splash (with white BG) is now used in macro mode instead of the DS(i) splash.
• @Epicpkmn11 and various: Added Catalan language.
  • Only usable in nds-bootstrap.

Improvements

• Changed Use bottom screen to Display Screen: Top/Bottom in the GBARunner2 page of TWLMenu++ Settings.
• @Epicpkmn11 and various: Updated translations.

Bug fixes

• Fixed Screen Aspect Ratio per-game setting displaying if Widescreen.cxi didn't exist.
• @lifehackerhansol: Fixed DS Lite backlight info not being properly saved when launching a flashcard game with Wood FW.
• Fixed language and region selection screens for macro mode.
• Fixed always using Grayscale for the transparent parts of battery, volume, and date/time.
• Other minor fixes.

Known bug

• The GBA splash for macro mode plays at half-speed.

v25.1.0: TWL Summer Release #6 Latest

What's new?

• @DeadSkullzJr: Updated AP-fix for Pokémon: SoothingSilver Version (v1.2.1 to v1.2.2)
• If the WiFi setting is found to be off, it'll now be auto-set to on.
• This is done for those who have previously updated to the TWLMenu++ version which sets the WiFi setting off by default for 3DS/2DS users.
• If you still don't want to use wireless/WiFi features, you must manually turn it off again in TWLMenu++ Settings.
• A TWiLight Menu++ .nds/.srldr file can no longer be launched from within TWiLight Menu++ itself.
• 3DS theme: The rotating cubes are now displayed in B&W/Grayscale mode.

Bug fixes

• @Epicpkmn11: Fixed volume icon, time text, and battery icon being placed over previous one(s) when updated.
• Fixed known bugs related to B&W/Grayscale mode.

Known bug

• The HBL theme will now have the volume icon, time text, and battery icon show a gray background behind them.

v25.0.1 (hotfix)

Bug fixes

• Fixed music in .raw format from custom skins of DSi-based themes not playing.
• The image viewer now reads the SD removal detection setting.

v25.0.0: More than just games! (TWL Summer Release #5)

What's new?

• With a video player (tuna-viDS) being bundled, TWLMenu++ now has a feature to view image files as well!
• The addition of tuna-viDS and this feature brings TWiLight Menu++ close to it's goal to be the next Moonshell!
• .bmp, .gif, and .png files are supported.
• Trying to load an image containing a width larger than 256px and/or height larger than 192px will be displayed as a black screen instead.
• Listen to the menu music from Nintendo DSi Camera while viewing the image!
• @lifehackerhansol: The Acekard 2i, R4 Ultra and R4iTT flashcart loaders have been rolled into one!
• The BL2CK loader is now used.
• Improvement
• @lifehackerhansol: Updated ak2_sd.dldi to support R4iDSN/R4 Ultra as well.
• As a result, r4idsn_sd.dldi has been deleted.

Bug fixes

• PPSEDS r11 now runs in DS mode by default.
• DSi-based themes: A non-ADPCM .wav file contained in a custom skin should now be read properly.
• Fixed not booting via hiyaCFW, depending on the SysNAND Region/Launcher settings.
• Other minor fixes.

Known bugs

• Animated .gif files will appear static.
• 4-bit .bmp files are not supported. A black screen will be shown instead.
• Trying to launch a title stored on an Acekard 2(i) with Slot-1 microSD access enabled will still crash on white screens.
• The image viewer currently ignores the SD removal detection setting, so ejecting the SD card will trigger the SD removal screen regardless.

v24.12.1 (hotfix)

What's new?

• @lifehackerhansol: The _BOOT_DS.NDS file has been removed for R4i-SDHC flashcard users, and loading TWLMenu++ now takes place in the R4.dat file.

Bug fix

• Fixed DS mode not being set if a certain launched title is blacklisted from using TWL clock speed, when launching the Last-run ROM title from hiyaCFW, or if soft-resetting in a DS game under a specific condition.

v24.12.0: TWL Summer Release #4

What's new?

• DSiWarehax users: If a DSi donor ROM hasn't been set yet, one from TWLNAND (ex. Nintendo DSi Sound, and/or a valid title the exploit uses) will automatically be set when you start TWLMenu++!
• Directly loading nds-bootstrap's HB bootloader is now an option. (Disabled by default to work around bugs.)
• @Epicpkmn11: Cheat names will now scroll in the R4/GBC themes!

Improvement

• @Epicpkmn11 and various: Updated translations.

Bug fixes

• The Run in setting is now hidden and defaults to DS mode, if TWL clock speed is blacklisted for a certain title.
• Fixed DS homebrew showing VRAM boost as DSi mode if Run in is set to Default.
• As a TWLNAND mount bug got fixed, Unlaunch is no longer used to reboot into TWLMenu++, when launched via hiyaCFW.

v24.11.0: TWL Summer Release #3 Latest

What's new?

• @DeadSkullzJr: Replaced AP-fix for v1.2.0 of Pokémon: SoothingSilver Version with one for v1.2.1.
• Replaced broken AP-fix for SD Gundam Sangoku Den - Brave Battle Warriors - Shin Militia Taisen with working cheat version.

Improvement

• @Epicpkmn11 and various: Added Valencian language, and updated translations.

Bug fixes

• The Ex. ROM space in RAM setting can no longer be changed if title is set to run in DSi mode.
• Fixed nds-bootstrap not found message not showing when loading DS homebrew, and if nds-bootstrap-hb doesn't exist in sd:/_nds/.

v24.10.0: TWL Summer Solstice Release

What's new?

• Added AP-fixes for Inazuma Eleven 3 and Ni no Kuni (Spanish translations).
• nds-bootstrap-hb's bootloader is now directly loaded, eliminating the middleman, so booting old DS homebrew is now 2 seconds faster!
  • Currently only applies to DSi-based themes and the DS Classic Menu, the latter of which pre-loads the homebrew's ARM9 binary for a slightly faster boot.
• The Direct boot setting has been removed for console SD users.
  • Pre-2009 DS homebrew will now always use nds-bootstrap, and 2009 or later homebrew will use nds-bootstrap if either DS mode or a RAM disk is set.
• For homebrew with large ARM9 binaries (ex. SM64DSi), all per-game settings except Language and Region are now hidden.
• With FastVideoDS still to come in the future, an old obscure video player, tuna-viDS (by @chishm), has been added for Xvid (.avi) video playback!
  • See this guide for how to convert a video, starting from Step 2.
• SNEmulDS has been reverted to the legacy pre-TGDS build to work around a few bugs.
  • As the TGDS build is still bundled, you can switch to it by setting NEW_SNES_EMU_VER to 1 in sd:/_nds/TWiLightMenu/settings.ini.
• The VRAM mode setting can now be changed for when running NTR games in DSi mode.

v24.9.1

Bug fix

• Fixed TWLMenu++ not starting via hiyaCFW, by having Unlaunch start it instead. (For real, this time.)
• It is still not recommended to have hiyaCFW autostart TWLMenu++, as it takes more time than usual. If you're looking to autoboot TWLMenu++, then set NO BUTTON to TWiLight Menu++ (boot.nds) in Unlaunch options.

v24.9.0

What's new?

• Added AP-fixes for Pokemon HeartGold & SoulSilver (Latin Spanish translation).
• When detecting rumble, it no longer checks for TIDs of GBA games, in order for custom GBA carts with rumble to work as well.
• Updated ESRB game list to add more games. (c0645f6)
• The External FIRMs and modules setting in Luma config is now checked before rebooting to widescreen.
  • Make sure Luma is on v11 or later for this to work.
• The brightness can now be changed in the DS Classic Menu on DS lite consoles!

Improvement:

• @Epicpkmn11 and various: Improved translations.

Bug fixes:

• Fixed a long-standing bug where sleep mode would not work and/or cause a crash (with a glitched top screen) after exiting.
  • This is achieved by implementing a custom sleep mode handler, as the one in libnds is bugged.
• Fixed another long-standing bug where a certain area of RAM gets cleared while using Memory Pit.
  • This allows the complete font set to be loaded without issues in Memory Pit.
• @lifehackerhansol: The flashcard kernel (Wood, in this case) now uses the correct save file extension (being .sav instead of .nds.sav).
• The brightness level on DS lite no longer self-changes while using the flashcard kernel (Wood, in this case) to run games!
• Fixed AP warning not shown for Mario & Luigi RPG: Siganui Partner (Korea), if AP-fix doesn't exist.
• DSi-based themes: Fixed crash when opening per-game settings for a DS(i) ROM with no icon.
• Fixed TWLMenu++ not starting via hiyaCFW, by having Unlaunch start it instead.

v24.8.0

What's new?

• @DeadSkullzJr: Added AP-fix for Pokémon: SoothingSilver Version (v1.2.0).
• DSi theme: Added support for rumble, when moving the cursor!
• Requires the DS Rumble Pak, Drill Dozer, or WarioWare: Twisted.
• A message will now appear when attempting to launch a DSiWare title from a flashcard in DS mode on DSi or 3DS consoles.
• The donor ROM message can no longer be skipped without viewing the second page of it.
• 3DS theme: Message box now pops up instead of sliding in.

Bug fixes

• Save files are now checked before the per-game settings are shown, instead of selecting a save slot.
• Fixed reverting to DSi theme after rebooting with GBC theme set.
• Fixed donor ROM message not appearing if nds-bootstrap setting (for DS games) is disabled when launching DSiWare titles from flashcard.
• Tried fixing autoboot with hiyaCFW not working (thus, untested).
• Icon is now not animated in hiyaCFW.

v24.7.0

• Reminder: If you get a white screen crash instead of the ROM menu being shown, hold SELECT during the splash screen or after you launched TWLMenu++, to open TWLMenu++ Settings, and change the DSi/3DS Theme Music setting to something other than Theme.

What's new?

• Updated B4DS DSiWare whitelist to accommodate for the included nds-bootstrap version.
• Added warning messages when launching Art Style: Aquia, Flipper, and Mighty Milky Way on flashcards in DS mode.
• (@Epicpkmn11) Allowed skins to set username/date/time X/Y and override settings for macro mode.

Improvement:

• (@Epicpkmn11 and various) Updated translations.

Bug fixes:

• R4/GBC themes: Fixed recent console icon additions not being displayed.
• Fixed trying to read custom skin BGM, if no custom skin is found.
• Slot-1 is now inited properly, regardless of the Slot-1 microSD access setting.
  • This allows certain flashcards to be launched (ex. Gateway Blue Card).
• Fixed Set as Donor ROM option not showing on flashcards if nds-bootstrap is off.
• (@DieGo367) Various grayscale color mode fixes.
• Fixed bugged sounds in Pictochat and DLP, if not using DSiWarehax.

v24.6.0

What's new?

• Updated B4DS DSiWare whitelist to accommodate for the included nds-bootstrap version.
• (@spellboundtriangle) Added widescreen patch for beebzDS (Demon Turf DS).
• (@Epicpkmn11) Added setting nds-bootstrap game manual!
• (@DieGo367) Themes can now use multiple font palettes! (#1894)
• (@DieGo367) Themes can now have fonts bundled! (#1895)
• (@DieGo367 & @Epicpkmn11) Added Use skin font setting! (#1896)

v24.5.0 What's new?

• (@lifehackerhansol) The icon is now animated again!
  • 3DS: For this to take effect, delete TWiLight Menu++ in System Settings, before updating. (Using FBI to delete it will work as well, but make sure TWLMenu++ is gone from the HOME Menu, before updating.)
• (@DeadSkullzJr) Added AP-fixes for:
  • Metal Max 2: Reloaded (English translation)
  • Nora to Toki no Koubou: Kiri no Mori no Majo (English translation v0.3c)
  • Pokémon: Moon Black 2
  • SaGa 2: Hihou Densetsu: Goddess of Destiny (English translation)
• Deleted AP-fixes for randomized Pokémon ROMs, as each one have varying headers.
• (@Epicpkmn11) Launcher App & SysNAND Region are now autodetected from DSi NAND.
• When launching a GBA ROM using the Native feature on DS Phat/Lite, holding D-Pad Left & R shoulder buttons will now activate a feature hidden in the console, which swaps green intensity between every two pixels.
  • As this is not a visible feature in TWLMenu++ Settings, it should only be used for testing purposes.
  • Will not work with EZ-Flash 3 in 1.

Improvement:

• (@Epicpkmn11 and various) Updated translations.

Bug fixes:

• (@Epicpkmn11) Fixed DSi icon palettes in DSi-based themes. (See #1884 for more info.)
• (@Epicpkmn11) ROM folder is now reset if missing.
• (@DeadSkullzJr) Fixed AP-fix for Metal Max 2: Reloaded.

v24.4.0

What's new?

• (@DeadSkullzJr) Added AP-fixes for Pokémon: Blaze Black 2 & Pokémon: Volt White 2 (v1.2).
• Added four new splash screen variants for April Fools and the release dates of the Virtual Boy console, Super Mario 64 DS, and Style Savvy.
• The Virtual Boy variant of the DS(i) splash screen will now also be shown on the release date of the Virtual Boy console.
• (@xonn83) Added GBMacro version of jEnesisDS for use with Macro Mode.

Bug fix:

• Fixed TWL clock speed being used by default when launching Slot-1 cartridges.

v24.3.1

What's new?

• (@DeadSkullzJr) Added AP-fix for English translation of Nora to Toki no Koubou: Kiri no Mori no Majo v0.1a.
• (@Epicpkmn11) DSiWare Booter and nds-bootstrap have been added as per-game settings (the latter of which only appears on flashcards).
• (@Epicpkmn11) * is now shown next to existing save numbers.
• (@Yrouel) nds-bootstrap .ver files are now read outside of the TWiLightMenu folder.

Bug fix:

• Fixed white screen / guru error crash when using the DSi theme in Memory Pit.

v24.3.0

What's new?

• (@lmazet) Added Amstrad CPC to TWLMenu++ Virtual Console!
  • This has only been tested on flashcards.
• The DSi binary message is now displayed before the Donor ROM message, when running via DSiWarehax (such as Memory Pit, Flipnote Lenny, etc.), and if the DSi binaries are missing from a DSi-Enhanced ROM.
• (@Epicpkmn11) Swapped 1st and 2nd banner lines, in order for Unlaunch to display which .srldr files are which, without looking at the bottom screen.
• (@Epicpkmn11) To save a couple of MB (megabytes), all bundled skins has been removed.
  • They can still be downloaded from the TWiLight Menu++ Skins site.

Improvement:

• With the release of Pokémon Blaze Black 2 Redux & Pokémon Volt White 2 Redux, which cannot boot in DSi mode, the DSi binary check has been improved further.

Bug fixes:

• RTC fix has been ported from nds-bootstrap, when running Slot-1 cartridges.
• Fixed Error 1 when launching Slot-1 game in widescreen or through the Last-run ROM title.
• (@lifehackerhansol) Fixed R4iDSN autoboot and flashcart loaders.
• (@lifehackerhansol) Fixed Ace3DS+ autoboot.
• 3DS theme: Fixed rotating cubes sometimes not disappearing before displaying box art.
• Fixed SD writes causing random lockups.
  • This has not been fully tested, so there's a very low chance that lockups will still occur.
• Fixed nds-bootstrap-specific per-game settings not saving for DSi-Enhanced/Exclusive titles, if nds-bootstrap is turned off for flashcards.
• Fixed nds-bootstrap settings not saving, if running from flashcard with SCFG enabled.
• Photo/box art color de-band has been defaulted to off to fix black lines appearing.
  • If you installed a TWLMenu++ version before this one, you'll need to manually turn it off, if you want to remove the black lines.

v24.2.1

Improvement:

• (@Epicpkmn11 and various) Updated translations.

v24.2.0

What's new?

• TWLMenu++ Splash Screen: Mario-themed splash variant has been added for MAR10 Day.
• Progress bar is now shown when creating save data.
• Replaced broken GoldenEye 007 AP-fix with working cheat version.
• (@R-YaTian) Replaced AP-fix for Chinese translation of Kyokugen Dasshutsu: 9-jikan, 9-nin, 9 no Tobira.
• (@spellboundtriangle) ramdisks folder is now hidden.

Bug fixes:

• (@Epicpkmn11) Custom icons under 32x32 are now allowed.
• DSi: Fixed backlight change not working in DS Classic Menu.
• Fixed save not being created/used for Super Mario 256 (for real, this time).
• (@spellboundtriangle) Rune Factory games are now unable to use TWL clock speed, due to bugs.
• Fixed System Settings not launching on EUR/AUS consoles, when selected in TWLMenu++ Settings.

v24.1.1

What's new?

• (@DieGo367) Added custom icons for folders. (#1819)

Bug fixes:

• Save data is now created for DS ROMs containing NTRJ as the TID.
• Should fix saving not working in Super Mario 256.
• Fixed WiFi being off by default on 3DS consoles.
• Note: If you've previously updated to v24.0.0 or v24.1.0, please make sure WiFi is set to On in TWLMenu++ Settings, if you want to use wireless features.
• Settings: Fixed System Settings not launching.

v24.1.0

What's new?

• (@R-YaTian) Added some AP-fixes:
• Fire Emblem: Shin Monshou no Nazo Hikari to Kage no Eiyuu (v3.01 English translation With Update Beta2) (Revision to fix DSi binary file)
• Fushigi no Dungeon: Fuurai no Shiren 5: Fortune Tower to Unmei no Dice (Chinese translation)
• Kyokugen Dasshutsu: 9-jikan, 9-nin, 9 no Tobira (Chinese translation)
• RPG Tkool DS (Chinese translation) (Revision to fix DSi binary file)
• To prevent potential issues, the leftover AP-fix file of opposite format is now deleted when launching a DS(i) game containing AP.
• (@DieGo367) Added loading custom icons from PNG files (works on non-DS ROMs). (#1800)
• (@Epicpkmn11) banner.bin can be used as well.
• (@Epicpkmn11) Removed Chinese/Korean bundled fonts.
• Switched Chinese font to WenQuanYi.
• Falls back to default, if not found.
• Card Read DMA setting is now shown for DSi-Exclusive games as well.
• Removed various games from the card read DMA blacklist.

Bug fixes:

• Fixed the AP-fixes for Dragon Quest V (JAP) & Hotel Dusk: Room 215 (KOR), by using fixes based on the cheat versions.
• Fixed settings menu and manual crashing when exiting (which the SD write code wasn't causing it most of the time, but can still cause it sometimes).
• Fixed Expand ROM space in RAM being shown for DSi-Exclusives.
• DSi/Saturn/HBL theme: Fix SD switch missing from SELECT menu, when running from flashcard with unlocked SCFG.
• Fixed DSi power LED briefly blinking purple if set to Blue/Red in TWLMenu++ Settings.
• DSiWare Booter setting is no longer shown on 3DS consoles, as only nds-bootstrap is used to boot DSiWare.
• On 3DS, SysNAND Region setting is now only shown, if running via DSiWarehax.
• Corrected ESRB rating for Bangai-O Spirits.

v24.0.0

What's new?

• (@spellboundtriangle) Added Ermii Kart DS: Legacy Edition and CTGP Nitro 1.0.0 widescreen patches.
• New valentine-themed background for the TWLMenu++ splash screen!
• The WiFi setting is now shown on 3DS consoles.
• DSi consoles: You can now change the Power LED color to purple!
  • In addition, depending on the theme, the battery icon color will change as well.
• To cut down on wait times, the maximum limit of found files/folders (even those not displayed) is now 320.
• DSi(Ware) SDK5.0 Donor ROM is now set separate from the SDK5.x one.
  • SDK5.0 ROM is required for Nintendo DSi Camera to run in general DSiWarehax.
• The .ngc (Neo-Geo Color) filetype is now supported.
• SNEmulDS is now updated. An on-the-fly generated RAM disk by nds-bootstrap is no longer used to run SNES games.
• (@Epicpkmn11) Added GBA game detection in DS Classic Menu.
• (@Epicpkmn11) DSi/3DS/HBL themes: Progress bar is now shown while preparing music.
• (@lifehackerhansol) Added Ace3DS+ and R4iTT 3DS (and clones) flashcart loaders.
• (@lifehackerhansol) Added iTouchDS autoboot.
• In order to free up some space, the DS Classic music has been removed.
  • In case you miss it later on, it can be re-added to the DSi theme's folder as a custom music option. Download.

Improvement:

• Donor ROM messages have been reworked.

Bug fixes:

• Disabling the WiFi setting should now work properly, with the console unable to search for internet access points, as well as fixing the communication error in Gen 4 Pokemon games, for those with a broken or incorrectly-seated WiFi card.
• Fixed Use ROM Region setting not being overridden if region is set in per-game settings.
• OpenLara now boots in native GBA mode.
• (@Epicpkmn11) If music conversion failed, it will now be redone on reboot.
• (@lifehackerhansol) Fixed booter_fc poweroff fail on DS.
• (@Epicpkmn11) Fixed SD inserted check.
• In the per-game settings, USA text is now shown, if TID ends with O.

Release notes.

Credits

Main Developers:

• RocketRobz: Lead Developer, implementing the auto-reset power button function used in NTR-mode.
• chyyran: Porting the akMenu/Wood UI to TWiLight Menu++ & adding the ability to load sub-themes off the SD card for DSi/3DS themes.
• Pk11: Adding the ability to load sub-themes off the SD card for the R4 theme, implemented sorting & made manuals use PNG, improved font rendering, providing a custom background for Unlaunch, and various bug fixes.

App Launchers:

• ahezard & shutterbug2000: nds-bootstrap (used to launch Nintendo DS ROMs off the SD card), and NDMA SD read code.
• Drenn: GameYob (used to launch Gameboy ROMs).
• Coto: Working on SNEmulDS with acheid/Loopy (used to launch SNES ROMs) & nesDS (TWL Edition by Apache Thunder) (used to launch NES ROMs).
• Lordus: jEnesisDS (used to launch Sega Mega Drive/Genesis ROMs).
• Ryan FB & xonn83: PicoDriveDS (used to launch large Sega Mega Drive/Genesis ROMs).
• Gericom: GBARunner2 (used to launch GameBoy Advance ROMs outside of the DS Phat/lite's GBA mode).
• FluBBa: S8DS (used to launch Sega Master System/Game Gear ROMs).
• Alekmaul & wavemotion: StellaDS, A5200DS, A7800DS, and XEGS-DS (used to launch Atari 2600/5200/7800/XEGS ROMs).

Graphics & Themes:

• spinal_cord: DSi4DS and DSision2 graphics.
• StarvingArtist: Game Console icons.
• FlameKat53: Manual icon for DSi theme's SELECT menu.
• fail0verflow, Fluto, and Arkhandar: Homebrew Channel/Launcher graphics.
• davi: Border for GBC theme (originally for GameYob).
• NightScript: Reworked Manual pages.

Music:

• IkaMusumeYiyaRoxie: General N64 MIDI Soundfont, used for the title splash fanfare.

External links

• Official website - https://wiki.ds-homebrew.com/twilightmenu
• GitHub (TWiLightMenu) - https://github.com/DS-Homebrew/TWiLightMenu
• GitHub (TWLBot) - https://github.com/TWLBot/Builds
• GBAtemp - https://gbatemp.net/threads/ds-i-3ds-twilight-menu-gui-for-ds-i-games-and-ds-i-menu-replacement.472200