/TWiLightMenu

DSi Menu replacement for DS/DSi/3DS/2DS

Primary LanguageC++GNU General Public License v3.0GPL-3.0


GBAtemp Thread Discord Server Build status on GitHub Actions Localized on Crowdin

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(i), SNES, NES, GameBoy (Color), GameBoy Advance, Sega GameGear/Master System, SG-1000/SC-3000 & Mega Drive/Genesis, Atari 2600/5200/7800/XEGS, MSX, Intellivision, Neo Geo Pocket, Sord M5, PC Engine/TurboGrafx-16, WonderSwan, and ColecoVision ROMs, as well as DSTWO plugins (if you use a DSTWO).

Compiling

Setting up

Compiling this app requires devkitPro's devkitARM, libnds, grit, and mmutil. These can be installed using devkitPro pacman with the following command:

sudo dkp-pacman -S nds-dev

(Note: Command will vary by OS, sudo may not be needed and it may be just pacman instead.)

Building

Once you have devkitPro's toolchains installed you can build the entirety of TWiLight Menu++ by simply running make package in the root of the repository. If you only want to build a specific part of TWiLight Menu++ you can cd to that folder and run make dist.

Once it finishes building, the output files will be in the 7zfile folder following the same directory structure as the official TWiLightMenu.7z builds.

Using Docker

Using the included Docker image, you can easily compile TWiLight Menu++ without having to manually set up the required version of devkitARM using the provided PowerShell (.ps1) scripts.

The script accepts make arguments as well. For example, .\compile_docker.ps1 clean will clean the directories of all the compiled code. If you would like to build all artifacts, run .\compile_docker.ps1 package.

Please note that Docker compilation is not compatible with native compilation on Windows. You should run .\compile_docker.ps1 clean to clean the artifacts before attempting to build with Docker. If a notification appears asking you to share your drive, you must choose to enable drive sharing for Docker to work on Windows.

Manual Pages

The manual pages are stored in a separate repository and downloaded from a release when building TWiLight Menu++. For more information, see the twilight-manual repository.

Translating

You can help translate TWiLight Menu++ on the Crowdin project. If you'd like to request a new language be added then please ask on the Discord server.

Credits

Main Developers

  • Rocket Robz: Lead Developer
  • 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 skins off the SD card for the R4 theme, implemented sorting & made manuals use PNG, improved font rendering, providing a custom background for Unlaunch, managing translations, and various bug fixes

Secondary Developers

  • DieGo: Adding support for custom ROM/folder icons and improvements for custom skins
  • lifehackerhansol: Improving support for flashcard autobooting and kernel loading
  • NightScript: Code cleanup, defining code standards, added flashcard functionality for Wood UI theme, manual pages

App Launchers

Graphics & Themes

Music

  • BlastoiseVeteran: Remastered version of Nintendo DSi Shop music
  • IkaMusumeYiyaRoxie: General N64 MIDI Soundfont, used for the title splash fanfare on old versions

Sound

  • dbry: Xtreme Quality IMA-ADPCM decoder code from adpcm-xq.
  • Firexploit: 3DS UI sounds for the 3DS theme, which some are also used in the DSi theme.

Others

Translators