TWiLightMenu

**TW**i**L**ight Menu++ is an open-source DSi Menu upgrade/replacement for the Nintendo DSi, the Nintendo 3DS, and Nintendo DS flashcards. It can launch games for the Nintendo DS, Nintendo DSi, and GameBoy Advance, as well as DSTWO plugins (if you use a DSTWO). # Add-ons Additional features can be added on to **TW**i**L**ight Menu++. See [this page](https://wiki.ds-homebrew.com/twilightmenu/installing-addons) for more information. # Compiling ## Setting up Compiling this app requires devkitPro's devkitARM, libnds, grit, and mmutil. These can be installed using [devkitPro pacman](https://devkitpro.org/wiki/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.) ## Cloning The repository contains submodules, so you need to clone recursively: ``` git clone --recursive https://github.com/DS-Homebrew/TWiLightMenu.git ``` If you cloned without pulling the submodules, you may update them afterwards: ``` git submodule update --init --recursive ``` ## 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](https://docker.com) 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](https://github.com/DS-Homebrew/twilight-manual) repository. ## Subfolders TWiLight Menu++ is composed of multiple "sub-projects" which all work together to create the DSi Menu replacement. Most subfolders in the repository contain their own code which will compile a `xxx.nds` file, which is generally copied to `/_nds/TWiLightMenu/xxx.srldr` inside the `7z` file (or `7zfile` folder). - **3dssplash**: opens 3ds and cia files (?) - Compiled to `/_nds/TWiLightMenu/3dssplash.srldr` - **booter**: main entrypoint, the first file loaded by the console if using SD-card or CFW - Creates `/BOOT.nds` and `/title/00030004/53524c41/content/00000000.app` (same file). - **booter_fc**: main entrypoint for flashcards - Creates `_DS_MENU.dat`, `dsedgei.dat`, `akmenu4.nds`, `_DSMENU.nds`, `SCFW.SC` and others. - gbapatcher - **imageview**: image viewer similar to DSi camera (gif, png, bmp) (Part of the Multimedia add-on) - `/_nds/TWiLightMenu/imageview.srldr` - **manual**: instruction manual for TWiLight Menu++ - Creates `/_nds/TWiLightMenu/manual.srldr` - **quickmenu**: DS Lite menu, the old classic UI - Creates `/_nds/TWiLightMenu/mainmenu.srldr` - **romsel_aktheme**: menu for the Wood UI - Creates `/_nds/TWiLightMenu/akmenu.srldr` - **romsel_dsimenutheme**: menu for the "Nintendo DSi", "Nintendo 3DS", "SEGA Saturn", and "Homebrew Launcher" UIs - Creates `/_nds/TWiLightMenu/dsimenu.srldr` - **romsel_r4theme**: menu for the "R4 Original" and "Gameboy Color" UIs - Creates `/_nds/TWiLightMenu/r4menu.srldr` - **settings**: settings menu - Creates `/_nds/TWiLightMenu/settings.srldr` - **slot1launch**: - Creates `/_nds/TWiLightMenu/slot1launch.srldr` - **title**: boot splash screen (Nintendo logo by default) - Creates `/_nds/TWiLightMenu/main.srldr` # Translating You can help translate TWiLight Menu++ on the [Crowdin project](https://crowdin.com/project/TwilightMenu). If you'd like to request a new language be added then please ask on the [Discord server](https://ds-homebrew.com/discord). # Credits ## Main Developers - [Rocket Robz](https://github.com/RocketRobz): Lead Developer - [chyyran](https://github.com/chyyran): Porting the akMenu/Wood UI to TWiLight Menu++ (before re-development) & adding the ability to load themes off the SD card for DSi/3DS UIs - [Pk11](https://github.com/Epicpkmn11): Adding the ability to load custom themes off the SD card for the original R4 UI, implemented sorting & made manuals use PNG, improved font rendering, providing a custom background for Unlaunch, managing translations, and various bug fixes ## Secondary Developers - [DieGo](https://github.com/DieGo367): Adding support for custom ROM/folder icons and improvements for custom themes - [lifehackerhansol](https://github.com/lifehackerhansol): Improving support for flashcard autobooting and kernel loading - [Deletecat](https://github.com/Deletecat): Original R4SDHC autoboot file containing a [flashcard-bootstrap](https://github.com/lifehackerhansol/flashcard-bootstrap) binary - [NightScript](https://github.com/NightScript370): Code cleanup, defining code standards, added flashcard functionality for Wood UI (before re-development), manual pages - [asiekierka](https://github.com/asiekierka): Stargate 3DS autoboot file from [nds-miniboot](https://github.com/asiekierka/nds-miniboot) ## App Launchers - [ahezard](https://github.com/ahezard), [shutterbug2000](https://github.com/shutterbug2000) and [Rocket Robz](https://github.com/RocketRobz): [nds-bootstrap](https://github.com/ahezard/nds-bootstrap) (used for launching Nintendo DS(i) ROMs off the SD card) - [Alekmaul](https://github.com/alekmaul) & [wavemotion](https://github.com/wavemotion-dave): [StellaDS](https://github.com/wavemotion-dave/StellaDS), [A5200DS](https://github.com/wavemotion-dave/A5200DS), [A7800DS](https://github.com/wavemotion-dave/A7800DS), [A8DS](https://github.com/wavemotion-dave/A8DS) (used for launching Atari 2600/5200/7800/XEGS ROMs), and [ColecoDS](https://github.com/wavemotion-dave/ColecoDS) (used for launching ColecoVision, MSX, Sord M5, and Sega SG-1000/SC-3000 ROMs) - archiede: [SNEmulDS](https://www.gamebrew.org/wiki/SNEmulDS) (used for launching SNES ROMs) - [Coto](https://github.com/cotodevel/): [SNEmulDS Revival](https://github.com/cotodevel/snemulds) - [chishm](https://github.com/chishm): [tuna-viDS](https://github.com/chishm/tuna-vids) (used for playing Xvid videos) - [Stewmath](https://github.com/Stewmath): [GameYob](https://github.com/Stewmath/GameYob) (used for launching Gameboy ROMs) - [FluBBaOfWard](https://github.com/FluBBaOfWard): [S8DS](https://github.com/FluBBaOfWard/S8DS) (used for launching Sega Master System, Game Gear, SG-1000/SG-3000, and ColecoVision ROMs), [NitroGrafx](https://github.com/FluBBaOfWard/NitroGrafx) (used for launching PC Engine/TurboGrafx-16 ROMs), [NitroSwan](https://github.com/FluBBaOfWard/NitroSwan) (used for launching WonderSwan ROMs), and [NGPDS](https://github.com/FluBBaOfWard/NGPDS) (used for launching Neo Geo Pocket ROMs) - [FluBBaOfWard](https://github.com/FluBBaOfWard), [Coto](https://coto88.bitbucket.io/), and Loopy: [nesDS](https://github.com/DS-Homebrew/NesDS) (used for launching NES ROMs) - [Apache Thunder](https://github.com/ApacheThunder): [TWL Edition](https://github.com/ApacheThunder/NesDS) of nesDS - [Gericom](https://github.com/Gericom): [FastVideoDSPlayer](https://github.com/Gericom/FastVideoDSPlayer) (used for launching FastVideoDS videos) & [GBARunner2](https://github.com/Gericom/GBARunner2) (used for launching GameBoy Advance ROMs outside of the DS Phat/Lite's GBA mode) - [therealteamplayer](https://github.com/therealteamplayer): [Hicode+DSP](https://github.com/therealteamplayer/GBARunner2) merged builds of GBARunner2 included for DSi/3DS - [unresolvedsymbol](https://github.com/unresolvedsymbol): [rom3M+master "DSL-Enhanced"](https://github.com/unresolvedsymbol/GBARunner2-DSL-Enhanced) builds of GBARunner2 included for playing *Pokémon: Emerald Version* on flashcards - Lordus: [jEnesisDS](https://gamebrew.org/wiki/JEnesisDS) (used for launching Sega Mega Drive/Genesis ROMs) - [xonn83](https://github.com/xonn83): GBMacro version of [jEnesisDS](https://github.com/xonn83/jEnesisDS_macro) - [Rocket Robz](https://github.com/RocketRobz): [Rocket Video Player](https://github.com/RocketRobz/RocketVideoPlayer) (used for launching RocketVideoDS videos) - Ryan FB, [Rocket Robz](https://github.com/RocketRobz), and [xonn83](https://github.com/xonn83): [PicoDriveTWL](https://github.com/DS-Homebrew/PicoDriveTWL) (used for launching large Sega Mega Drive/Genesis ROMs) - [wavemotion](https://github.com/wavemotion-dave): [Nintellivision/NINTV-DS](https://github.com/wavemotion-dave/NINTV-DS) (used for launching Intellivision ROMs) and [SugarDS](https://github.com/wavemotion-dave/SugarDS) (used for launching Amstrad CPC ROMs) ## Graphics & Themes - [Absent-Reality](http://pixeljoint.com/p/19283.htm): Intellivision icon - davi: Border for GBC UI (originally for GameYob) - [fail0verflow](https://github.com/fail0verflow/), Fluto, and Arkhandar: Homebrew Channel/Launcher graphics - [FlameKat53](https://github.com/FlameKat53): Manual icon for DSi UI's `SELECT` menu - [Mr. Start](https://github.com/Arthur-Start): Super Nintendo DS splash screen - [PW5190](https://github.com/PW5190): These TWLMenu++ splash screens: - Kirby - Pokémon Day - Zelda - [spinal_cord](https://gbatemp.net/members/spinal_cord.90607/): [DSi4DS](https://gbatemp.net/threads/dsi4ds.173617/) and [DSision2](https://gbatemp.net/threads/dsision2.92740/) graphics - [StarvingArtist](https://www.deviantart.com/starvingartist/): Game Console icons ## Music - [BlastoiseVeteran](https://soundcloud.com/blastyveteran): Remastered version of Nintendo DSi Shop music - IkaMusumeYiyaRoxie: General N64 MIDI Soundfont, used for the title splash fanfare on old versions - [TeciorFILM](https://www.youtube.com/channel/UCEyPYQavt2g_tdmkd-pQgYw): The video ([10 Minutes of Nintendo DSi Menu Music (Authentic)](https://www.youtube.com/watch?v=LLc3-z8VZwc)) used for the better DSi Menu music add-on ## Sound - [dbry](https://github.com/dbry): Xtreme Quality IMA-ADPCM decoder code from [adpcm-xq](https://github.com/dbry/adpcm-xq). - [Firexploit](https://github.com/Firexploit): 3DS UI sounds, which some are also used in the DSi UI. ## Others - [ahezard](https://github.com/ahezard): NDMA code from nds-bootstrap - Another World & Yellow Wood Goblin: The original akMenu/Wood UI - [Rocket Robz](https://github.com/RocketRobz): Re-developed the Wood UI with pieces of the original code ported over - [Arisotura](https://github.com/Arisotura): ROM list from melonDS, and BIOS dumper code from [dsibiosdumper](https://github.com/Arisotura/dsibiosdumper) - [Dartz150](https://github.com/Dartz150): Provided fix for *Iridion II* & *Top Gun: Combat Zones* GBA games - [devkitPro](https://github.com/devkitPro): Code used in nds-hb-menu, and the use of the bootloader, devkitARM, libnds, and libfat - [edo9300](https://github.com/edo9300): DS Phat check code - [Gericom](https://github.com/Gerico