Toggle menu
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

TWiLight Menu++: Difference between revisions

From GameBrew
No edit summary
Pk11 (talk | contribs)
Major rewrite to SRLoader page to bring all the info up to date
Line 1: Line 1:
{{Infobox 3DS homebrew
{{Infobox homebrew
| title      = SRLoader
| title      = TWiLight Menu++
| image      = [[image:srloader.jpg|250px]]
| image      = [[image:srloader.jpg|250px]]
| type        = Homebrew Loaders
| type        = Homebrew Loaders
| version    = v2.1.0
| version    = v12.0.0
| licence    = Mixed
| licence    = MIT
| author      = Robz8
| author      = RocketRobz
| website    = https://github.com/Robz8/SRLoader
| website    = https://github.com/DS-Homebrew/TWiLightMenu
| download    = media:SRLoader_v2.1.0.rar
| download    = https://github.com/DS-Homebrew/TWiLightMenu/releases/download/v12.0.0/TWiLightMenu.7z
| source      = https://github.com/Robz8/SRLoader/archive/v2.1.0.tar.gz
| source      = https://github.com/DS-Homebrew/TWiLightMenu
}}
}}


<youtube>fc9-TtALeA8</youtube>
TWiLight Menu++, or TWLMenu++ for short, is a frontend for nds-bootstrap, for DS, DSi and 3DS.
 
==Features==
[[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.]]


NOTE: In this video, loading speed is slower than the current nds-bootstrap version.
* Launch DS(i) 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.
* 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.


SRLoader is a frontend for nds-bootstrap, for DSi.
==Installation==
===Non-CFW DSi/3DS/2DS users (Not recommended)===
# 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.
# Put .gb/.gba/.gbc/.gen/.gg/.nes/.nds/.sms/.smc/.sfc ROMs anywhere on your SD card.
# Launch your exploted DSiWare game, and TWiLight Menu++ will load!
'''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.


This does what [[TWLoader]] does, loading ROMs from the SD card via nds-bootstrap, and ROMs from a flashcard!
The following DSiWare exploits are compatible with nds-bootstrap without CFW:
DSi/3DS/2DS users can change sound frequency from 32kHz to 48kHz for higher sound quality!
* sudokuhax (uses GenericTWLPayload)
Outside of flashcards, you can run DS games with clock speed of 133mhz (faster than normal DS).
* fieldrunnerhax (uses GenericTWLPayload)
Also has theme changing, and it has an option, where you can run the last played DS ROM (ran via bootstrap/flashcard's ROM booter) on SRLoader startup.
* grtpwn (uses GenericTWLPayload)
* ugopwn/Flipnote Lenny (only for v0.11.0 and v0.11.2)


Also includes (Super) GameBoy (Color) ROM loading via GameYob.
----


==Compatible DSiWare exploits for nds-bootstrap==
===DSi users with Unlaunch and/or HiyaCFW===
They use GenericTWLPayload.
# 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.
* sudokuhax
# Extract the "boot.nds" file from the "DSi&3DS - SD card users" folder, to the SD Card root.
* fieldrunnerhax
# 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++!


===Instructions (No flashcard, DSi users/Non-CFW 3DS/2DS users)===
----
# Extract the files/folders in the 7z file, to the DSi's SD Card root.
# Put .nds ROMs in "sdmc:/roms/nds/".
# Put a Mario Kart DS ROM at "sdmc:/roms/nds/".
# Launch your exploted DSiWare game, and SRLoader will load!
# Press SELECT on MKDS to set it as donor ROM.
# You're good to go!


=== Instructions (No flashcard, 3DS/2DS users) ===
===CFW 3DS users, via Updater===
# Extract the files/folders in the 7z file, to the 3DS' SD Card root.
# 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].
# Put .nds ROMs in "sdmc:/roms/nds/".
# Launch the updater.
# Put a Mario Kart DS ROM at "sdmc:/roms/nds/".
# Touch Release next to TWL Menu++. Extraction may take a while.
# Install the SRLoader CIA, and launch it.
# Do Step 3 again, but for nds-bootstrap.
# Press SELECT on MKDS to set it as donor ROM.
# You're good to go!


=== Instructions (Flashcard users) ===
----


# Extract the files/folders in the 7z file, to the flashcard's microSD Card root.
===CFW 3DS users, manual method===
# Put .nds ROMs in "fat:/roms/nds/".
# 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++!


Download a pack for your flashcard:
----


* DSTT/R4i Gold/R4i-SDHC/R4 SDHC Upgrade/SC DSONE  - [[:File:DS Game Forwarder pack (R4iDSN, R4i Gold RTS, R4 Ultra).7z]]
===Flashcard users===
* Original R4/M3 Simply - [[:File:DS Game Forwarder pack (Original R4, M3 Simply).7z]]
# 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.
* R4iDSN/R4i Gold RTS/R4 Ultra - [[:File:DS Game Forwarder pack (R4iDSN, R4i Gold RTS, R4 Ultra).7z]]
# Extract the "boot.nds" file from the "Flashcard users" folder, to the flashcard's microSD card root.
* Acekard 2(i)/Galaxy Eagle/M3DS Real - [[:File:DS Game Forwarder pack (Acekard 2(i), Galaxy Eagle, M3DS Real).7z]]
# Put .gb/.gba/.gbc/.gen/.gg/.nes/.nds/.sms/.smc/.sfc ROMs anywhere on your flashcard's microSD card.
* Acekard RPG - [[:File:DS Game Forwarder pack (Acekard RPG).7z]]
# (Optional) Using your flashcard firmware to load retail/commercial ROMs instead of nds-bootstrap.
* Ace 3DS+/Gateway Blue Card/R4iLS/R4iTT - [[:File:DS Game Forwarder pack (Ace3DS, cards with r4isdh, GW Blue Card, R4iLS, R4iTT).7z]]
## Download a pack for your flashcard (skip to step 4, if your flashcard is not listed):
* SuperCard DSTWO - [[:File:DS Game Forwarder pack (SC DSTWO).7z]]
##* [[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.


Extract what's in "for Slot-1 microSD" to the root of the flashcard's microSD card.
==Video demonstration==
<youtube>fc9-TtALeA8</youtube>


You're good to go! Launch your flashcard, then boot "boot_fc.nds" (or "SRLoader" on DSTWO), and SRLoader will load!
NOTE: In this video, loading speed is slower than the current nds-bootstrap version.
Then, set your flashcard (and sound/mic frequency, if you're using a DSi/3DS/2DS).


==Controls==
==Controls==
* A: Launch game (via nds-bootstrap/flashcard's ROM booter. Retail ROMs and DLDI homebrew will work.)
===DSi, 3DS, and SEGA Saturn themes===
* Y (X in v0.0.2 and lower): Launch game/app (bootstrap/flashcard's ROM booter not used. Useful for DS(i) homebrew.)
* Left/Right: Select a game/app
* Start: Settings
* A/START: Launch game/app
* B: Return to DSi/3DS Menu
* 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)


===DS/3DS theme===
----


Up/Down: Select a game/app.
===R4 theme===
L: Switch between DS and (S)GB(C) ROMs.
''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


DSi Menu theme
----
Left/Right: Select a game/app.
Down: Switch between DS and (S)GB(C) ROMs.


nds-bootstrap
===Acekard theme===
L+R+DOWN+B: (3DS/2DS users only.) Return to the SRLoader menu.
* 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


Please check this list:
----
[https://docs.google.com/spreadsheets/d/1M7MxYQzVhb4604esdvo57a7crSvbGzFIdotLW0bm0Co/edit#gid=0 List of games that work from SD Card]


===Todo===
===With CFW: DS ROMs on SD/carts===
Add cheat menu.
* 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==
==FAQs==


'''Q: Why isn't touch input working on sudokuhax?'''
'''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: Depending on the save file of sudokuhax, the touch screen inputs may not work.
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: Can The Biggest Loser boot SRLoader?'''
'''Q: How do I get past Luma's exception screen when trying to soft-reset the game, or return to 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.
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?'''


'''Q: Why do I get a white screen when trying to load a game from SD Card?'''
A: Go into TWLMenu++ Settings, and disable "Update recently played list".


A1: If you're a DSi user, Please check the LED set in SRLoader settings.
'''Q: Can The Biggest Loser boot TWiLight Menu++?'''
* 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.


A2: If the game is listed as compatible, or if you're running from flashcard, try loading the game again. SRLoader tends to crash before loading a .nds file for some reason.
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 is sound working incorrectly?'''
'''Q: Why do I get a white screen when trying to load a game from SD Card, and how do I fix it?'''


A: For DSiWarehax users, the DSi BIOS is still being used in the arm7.
A1: You're using an incompatible DSiWare exploit. It should use GenericTWLPayload for DS ROMs to work.
You'll need [[RocketLauncher]] for sound to work properly.


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.


== Building==
A3: Please note that not all games work from SD Card yet. Check the list above.<br>
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).
If it's listed as compatible, try again.


== Credits ==
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.


- ahezard: [nds-bootstrap](https://github.com/ahezard/nds-bootstrap)
==Credits==
- Apache Thunder: DS menu top screen image.
===Main Developers===
- Joom: Original TWLoader logo.
* [https://github.com/RocketRobz RocketRobz]: Lead Developer, implementing the auto-reset power button function used in NTR-mode.
- me: For implementing the auto-reset power button function used in NTR-mode, and LED functions, to nds-bootstrap.
* [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.
- shutterbug2000: For the sound/touchscreen fix for nds-bootstrap.
* [https://github.com/Epicpkmn11 Pk11]: Adding the ability to load sub-themes off the SD card for the R4 theme.
- spinal_cord: DSi4DS assets.
===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 05:19, 18 February 2020

TWiLight Menu++
File:Srloader.jpg
General
Author(s)RocketRobz
TypeHomebrew Loaders
Versionv12.0.0
LicenceMIT
Links
Download
Website
Source
Advertisements

<htmlet>adsense</htmlet>

Advertising: