TWiLight Menu++: Difference between revisions

From GameBrew
m (Pk11 moved page SRLoader to TWiLight Menu++: SRLoader was renamed to TWiLight Menu++ a while ago)
(Created page with "{{Infobox 3DS homebrew | title = SRLoader | image = 250px | type = Homebrew Loaders | version = v2.1.0 | licence = Mixed | au...")
(154 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Infobox homebrew
{{Infobox 3DS homebrew
| title      = TWiLight Menu++
| title      = SRLoader
| image      = [[image:srloader.jpg|250px]]
| image      = [[image:srloader.jpg|250px]]
| type        = Homebrew Loaders
| type        = Homebrew Loaders
| version    = v12.0.0
| version    = v2.1.0
| licence    = MIT
| licence    = Mixed
| author      = RocketRobz
| author      = Robz8
| website    = https://github.com/DS-Homebrew/TWiLightMenu
| website    = https://github.com/Robz8/SRLoader
| download    = https://github.com/DS-Homebrew/TWiLightMenu/releases/download/v12.0.0/TWiLightMenu.7z
| download    = media:SRLoader_v2.1.0.rar
| source      = https://github.com/DS-Homebrew/TWiLightMenu
| source      = https://github.com/Robz8/SRLoader/archive/v2.1.0.tar.gz
}}
}}


TWiLight Menu++, or TWLMenu++ for short, is a frontend for nds-bootstrap, for DS, DSi and 3DS.
# SRLoader
SRLoader is a frontend for nds-bootstrap, for DSi.


==Features==
# Building
[[File:Widescreen comparison.jpg|thumb|right|Super Mario 64 DS being run in multiplayer via [[nds-bootstrap]] on DSi and 3DS, with the 3DS running in widescreen.]]
Building this app by yourself require DEVKITARM with DEVKITPRO. You will also need [Easy GL2D](https://www.odrive.com/s/eb3e676a-be1b-4a18-bc7d-67f25c80eb42-5917ab0b).


* Launch DS(i) ROMs from the SD card and/or flashcard, via [[nds-bootstrap]] (comes included with the app)!
# Credits
* For flashcards, the flashcard kernel/firmware can optionally be used to boot the games.
* 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 DSi-Enhanced, DSi-Exclusive, and DSiWare 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 following flashcards' microSD cards, and switch to and from there anytime!
** Acekard 2i (Games cannot be booted)
** R4 Ultra (regular, not R4i) (r4ultra.com)
* Set the language to your preference.
* Run the last played ROM on TWiLight Menu++ startup.
* Play retro games from these consoles:
** (Super) GameBoy (Color), via GameYob
** NES/Famicom, via nesDS
** Sega Master System/Game Gear, via S8DS
** Sega MegaDrive/Genesis, via jEnesisDS
** Super Nintendo/Famicom, via SNEmulDS
* 3DS/2DS users: Play DS games in 16:10 widescreen! Not all games will work with this feature.


==Installation==
- ahezard: [nds-bootstrap](https://github.com/ahezard/nds-bootstrap)
===Non-CFW DSi/3DS/2DS users (Not recommended)===
- Apache Thunder: DS menu top screen image.
# In the 7z file, extract the "_nds" folder from both the 7z root and the "DSi&3DS - SD card users" folder, to the SD Card root. Merge folders, when asked to.
- Joom: Original TWLoader logo.
# Extract the "boot.nds" file from the "DSi&3DS - SD card users" folder, to the SD Card root.
- me: For implementing the auto-reset power button function used in NTR-mode, and LED functions, to nds-bootstrap.
# Put .gb/.gba/.gbc/.gen/.gg/.nes/.nds/.sms/.smc/.sfc ROMs anywhere on your SD card.
- shutterbug2000: For the sound/touchscreen fix for nds-bootstrap.
# Launch your exploted DSiWare game, and TWiLight Menu++ will load!
- spinal_cord: DSi4DS assets.
'''NOTE for DSi users:''' If you're using exploits such as Memory Pit, ugopwn, Flipnote Lenny, or 4swordshax to boot TWiLight Menu++ some DS ROMs will not play sound properly.
 
The following DSiWare exploits are compatible with nds-bootstrap without CFW:
* sudokuhax (uses GenericTWLPayload)
* fieldrunnerhax (uses GenericTWLPayload)
* grtpwn (uses GenericTWLPayload)
* ugopwn/Flipnote Lenny (only for v0.11.0 and v0.11.2)
 
----
 
===DSi users with Unlaunch and/or HiyaCFW===
# In the 7z file, extract the "_nds" folder from both the 7z root and the "DSi&3DS - SD card users" folder, to the SD Card root. Merge folders, when asked to.
# Extract the "boot.nds" file from the "DSi&3DS - SD card users" folder, to the SD Card root.
# Extract what's in "DSi - CFW users/SDNAND root" to the root of your SD card.
# Put .gb/.gba/.gbc/.gen/.gg/.nes/.nds/.sms/.smc/.sfc ROMs anywhere on your SD card.
# (Unlaunch users) In Unlaunch menu, go to options, and set the "No button" option to "TWLMENUPP".
# Launch TWiLight Menu++!
 
----
 
===CFW 3DS users, via Updater===
# Use [[FBI]] to install the [[TWiLight Menu++ Updater]]. You can download it [https://github.com/RocketRobz/TWiLightMenu-Updater/releases here], or with this [https://gbatemp.b-cdn.net/attachments/twlmupdater-qrcode-png.187568/ QR code].
# Launch the updater.
# Touch Release next to TWL Menu++. Extraction may take a while.
# Do Step 3 again, but for nds-bootstrap.
 
----
 
===CFW 3DS users, manual method===
# In the 7z file, extract the "_nds" folder from both the 7z root and the "DSi&3DS - SD card users" folder, to the SD Card root. Merge folders, when asked to.
# Extract the "boot.nds" file from the "DSi&3DS - SD card users" folder, to the SD Card root.
# Extract the .cia files from the "3DS - CFW users" folder, to anywhere on the SD Card.
# Put .gb/.gba/.gbc/.gen/.gg/.nes/.nds/.sms/.smc/.sfc ROMs anywhere on your SD card.
# Install the .cia files you extracted. <br> '''NOTE:''' If you're using EmuNAND, then install them to SysNAND as well.
# Launch TWiLight Menu++!
 
----
 
===Flashcard users===
# In the 7z file, extract the "_nds" folder from both the 7z root and the "Flashcard users" folder, to the flashcard's microSD card root. Merge folders, when asked to.
# Extract the "boot.nds" file from the "Flashcard users" folder, to the flashcard's microSD card root.
# Put .gb/.gba/.gbc/.gen/.gg/.nes/.nds/.sms/.smc/.sfc ROMs anywhere on your flashcard's microSD card.
# (Optional) Using your flashcard firmware to load retail/commercial ROMs instead of nds-bootstrap.
## Download a pack for your flashcard (skip to step 4, if your flashcard is not listed):
##* [[Media:DS Game Forwarder pack (R4iDSN, R4i Gold RTS, R4 Ultra).7z|R4iDSN/R4 Ultra]]
##* [[Media:DS Game Forwarder pack (SC DSTWO).7z|SuperCard DSTWO]]
## Extract what's in "for Slot-1 microSD" to the root of the flashcard's microSD card.
## After this and setting up TWiLight Menu++ on your flashcard, set "Use nds-bootstrap" to "No" so the flashcard firmware will be used instead of nds-bootstrap.
# (Optional) Autobooting to TWiLight Menu++
#* Extract what's in "Flashcard users/Autoboot/(your flashcard)" to the root of the flashcard's microSD card. (Skip this, if you don't see your flashcard.)
# You're good to go! Launch your flashcard, and TWiLight Menu++ will load! (Load "boot.nds", if you're in the regular flashcard menu, or if autobooting doesn't work.)
* You can also set your preferred sound/mic frequency, if you're using a DSi, 3DS, or 2DS.
* If you want to use TWL clock speed and/or VRAM boost on your flashcard games, launch your flashcard using TWiLight Menu++ on the console's SD card, with the "SCFG access in Slot-1" setting turned on.
 
==Video demonstration==
<youtube>fc9-TtALeA8</youtube>
 
NOTE: In this video, loading speed is slower than the current nds-bootstrap version.
 
==Controls==
===DSi, 3DS, and SEGA Saturn themes===
* Left/Right: Select a game/app
* A/START: Launch game/app
* B: Go up one directory
* L/R: Switch pages
* Y: Per-game settings
** X: Cheat menu
* X: Delete/hide game
* (DSi/Saturn theme) SELECT: DS Classic menu
** (Where TWLMenu++ Settings, the Slot-1 game, and the last ran game can be accessed)
 
----
 
===R4 theme===
''On R4 theme main menu:''
* Left/Right: Select game list, lanch Slot-1, or launch GBARunner2
* A: Open game list, launch Slot-1, or launch GBARunner2
* START/SELECT: Open TWLMenu++ Settings
''In game list:''
* Up/Down: Select a game/app
* A: Launch game/app
* B: Go up one directory
* Y: Per-game settings
** X: Cheat menu
* X: Delete/hide game
* START: Return to R4 theme main menu
 
----
 
===Acekard theme===
* Up/Down: Select a game/app
* A: Launch game/app
* B/L: Go up one directory
* Y: Per-game settings
** X: Cheat menu
* START: Options menu
* SELECT: Change list mode
 
----
 
===With CFW: DS ROMs on SD/carts===
* L+R+DOWN+B for 2 seconds: Return to TWiLight Menu++.
** (If using an o3DS, then it does not work on all models)
 
For DS game compatibility, please check this list:
[https://docs.google.com/spreadsheets/d/1LRTkXOUXraTMjg1eedz_f7b5jiuyMv2x6e_jY_nyHSc/edit?usp=sharing List of games that work from SD Card]
 
==FAQs==
 
'''Q: (3DS users) This is a DS(i) emulator, right?'''
 
A: 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.<br>
The only consoles emulated are NES, Sega MS/GG, GB(C), Sega Gen/MD, SNES, and GBA (but partially, as some parts (such as graphics) are ran natively).
 
'''Q: After installing the TWiLight Menu++ CIAs, I don't see the app on the 3DS HOME Menu. How can I fix this?'''
 
Reboot the console.
 
'''Q: Why is my 3DS/2DS stuck on black screen when launching TWiLight Menu++? Why is my 3DS/2DS powering off when launching TWiLight Menu++?'''
 
A: TWL_FIRM might've somehow got corrupted.<br>
Follow this guide to fix the issue: [https://3ds.hacks.guide/troubleshooting#dsi--ds-functionality-is-broken-after-completing-the-guide DSi / DS functionality is broken after completing the guide]
 
'''Q: I followed all the steps on how to play in widescreen, but the supported games are still running in 4:3, but with glitchiness on the right side. How do I fix this?'''
 
A: Try re-downloading the patcher, and run "wide.bat" again, and copy the remade/updated .cxi file to "sd:/_nds/TWiLightMenu/TwlBg/", and rename it to "Widescreen.cxi".
 
'''Q: I followed all the steps on how to play in widescreen, but the supported games are still running in 4:3, but with hex numbers on the right side. How do I fix this?'''
 
A: You did not make and/or run "wide.bat". Please do that, and then copy the remade/updated .cxi file to "sd:/_nds/TWiLightMenu/TwlBg/", and rename it to "Widescreen.cxi".
 
'''Q: After launching a game in widescreen, the TWLMenu++ GUI is stretched in the top screen! How do I fix this?'''
 
A: In FBI, delete both TWiLight Menu++ titles (in purple text) in the title list, then install both the latest TWLMenu++ CIAs.<br>
Back in the title list, launch "TWiLight Menu++ Last-ran ROM".<br>
If this doesn't fix it, delete "TwlBg.cxi" at "sd:/luma/sysmodules/".
 
'''Q: How do I get past Luma's exception screen when trying to soft-reset the game, or return to TWiLight Menu++?'''
 
A: Enable game patching in Luma settings, or update Luma to v10.0 (or later).
 
'''Q: How do I fix TWiLight Menu++ restarting when launching a game? How do I fix TWiLight Menu++ giving a Guru Meditation Error when launching a game?'''
 
A: Go into TWLMenu++ Settings, and disable "Update recently played list".
 
'''Q: Can The Biggest Loser boot TWiLight Menu++?'''
 
A: No. As The Biggest Loser is a Slot-1 game, and not a DSiWare game, SD access is disabled when running Slot-1 cards.
 
'''Q: Why do I get a white screen when trying to load a game from SD Card, and how do I fix it?'''
 
A1: You're using an incompatible DSiWare exploit. It should use GenericTWLPayload for DS ROMs to work.
 
A2: nds-bootstrap shrinks the heap to fit it's own code for arm9, into cached memory. Shrinking the heap breaks some games.<br>
To disable heap shrink, hold L immediately after pressing A/START to launch the game.
 
A3: Please note that not all games work from SD Card yet. Check the list above.<br>
If it's listed as compatible, try again.
 
If you're a DSi user, Please check the LED set in TWiLight Menu++ settings.
* WiFi/Camera: If it's on, that means it's loading from the ROM. If it's off for a while, and the screen is still white, that means the game is unsupported.
* Power: If it's purple, that means it's loading from the ROM. If it's blue (or red) for a while, and the screen is still white, that means the game is unsupported.
 
==Credits==
===Main Developers===
* [https://github.com/RocketRobz RocketRobz]: Lead Developer, implementing the auto-reset power button function used in NTR-mode.
* [https://github.com/chyyran chyyran]: Porting the akMenu/Wood UI to TWiLight Menu++ & adding the ability to load sub-themes off the SD card for DSi/3DS themes.
* [https://github.com/Epicpkmn11 Pk11]: Adding the ability to load sub-themes off the SD card for the R4 theme.
===App Launchers===
* [https://github.com/ahezard ahezard] & [https://github.com/shutterbug2000 shutterbug2000]: [[nds-bootstrap]] (used to launch Nintendo DS ROMs off the SD card), and NDMA SD read code.
* [https://github.com/Drenn1 Drenn]: [[GameYob]] (used to launch Gameboy ROMs)
* [https://coto88.bitbucket.io/ Coto]: Working on [[SNEmulDS]] with acheid/Loopy (used to launch SNES ROMs) & [[nesDS]] ([https://github.com/ApacheThunder/NesDS TWL Edition] by [https://github.com/ApacheThunder Apache Thunder]) (used to launch NES ROMs).
* Lordus: [[jEnesisDS]] (used to launch Sega Mega Drive/Genesis ROMs)
* [https://github.com/Gericom Gericom]: [[GBARunner2]] (used to load GameBoy Advance ROMs)
* [https://gbatemp.net/members/flubba.19963/ FluBBa]: [[S8DS]] (used to launch Sega Master System/Game Gear ROMs)
===Graphics & Themes===
* [https://gbatemp.net/members/spinal_cord.90607/ spinal_cord]: [[DSi4DS]] and [[DSision2]] graphics.
* [https://www.deviantart.com/starvingartist/ StarvingArtist]: Game Console icons.
* [https://github.com/FlameKat53 FlameKat53]: Manual icon for DSi theme's `SELECT` menu.
===Others===
* [https://github.com/profi200 profi200]: Improved SD code from fastboot3DS.
* [https://github.com/devkitPro devkitPro]: Code used in [[nds-hb-menu]], and the use of the bootloader, [[devkitARM]], [[libnds]], and [[libfat]].
* Another World and Yellow Wood Goblin: The original akMenu/[[Wood Firmwares|Wood]] UI.
* [https://github.com/NightYoshi370 NightYoshi370]: Code cleanup

Revision as of 14:44, 8 February 2018

Template:Infobox 3DS homebrew

  1. SRLoader

SRLoader is a frontend for nds-bootstrap, for DSi.

  1. Building

Building this app by yourself require DEVKITARM with DEVKITPRO. You will also need [Easy GL2D](https://www.odrive.com/s/eb3e676a-be1b-4a18-bc7d-67f25c80eb42-5917ab0b).

  1. Credits

- ahezard: [nds-bootstrap](https://github.com/ahezard/nds-bootstrap) - Apache Thunder: DS menu top screen image. - Joom: Original TWLoader logo. - me: For implementing the auto-reset power button function used in NTR-mode, and LED functions, to nds-bootstrap. - shutterbug2000: For the sound/touchscreen fix for nds-bootstrap. - spinal_cord: DSi4DS assets.

Advertising: