TWLoader - CTR-mode NDS app

Discussion in '3DS - Homebrew Development and Emulators' started by Robz8, Nov 11, 2016.

  1. Robz8
    OP

    Robz8 Coolest of TWL

    Member
    5,781
    2,307
    Oct 1, 2010
    United States
    twloader.fw.png
    If you're a DSi user, use SRLoader.

    dsimenu v4.2.0.png r4 theme v4.2.0.png wood theme v4.2.0.png
    TWLoader is a CTR-mode GUI that looks and feels like the Nintendo DSi Menu (theme can be changed to R4 or akmenu/Wood).
    It is a frontend for nds-bootstrap, the SD ROM loader, and also a frontend for flashcards.
    It can also serve as a replacement for flashcard menus.
    With this, you can run your NDS games, with an enhanced 240p/3D-visual version of the DS/DSi boot screen, and clock speed of 133mhz (faster than normal DS).

    Video by @Nomelas


    You can also change the UI color to your favorite color, and have glowing rainbow colors in the Notification LED.

    Is this an emulator, you may ask? No. NDS/DSi games are ran natively in TWL_FIRM.

    FAQs are at the bottom of the post.

    (Always updated)
    Scan these QR Codes:
    GUI (1 code)
    TWL-NAND SIDE (2 codes)
    and Download here. (CIA files are in "sdmc:/_nds/twloader/cia/", if you skipped QR downloading.)
    NOTE: The 3DSX version only works with Rosalina functionality, so it doesn't work via payloads.
    NOTE2: The 3DSX demo version does not launch games, due to it being impossible with payloads.

    Music files
    Put "music.wav" at "sdmc:/_nds/twloader/".
    Music must be 44khz, and 1 minute.

    Instructions
    1. Extract the files/folders in the "sdroot" folder to the 3DS' SD Card root. Do not extract the "sdroot" folder itself to the SD Card root.
    2. Put .nds ROMs in "sdmc:/roms/nds/". Create the folders if they don't exist.
    3. v5.2.1 or below only: Dump the DSP firm, as that's needed to play the sound effects and music.
      Check here: https://gbatemp.net/threads/release-dsp-dump.423860/
    IMPORTANT NOTE: If you plan on do a system transfer, before you do it, uninstall both parts of the TWLNAND side app first, unless you want to keep using TWLoader on the system that had it's stuff transferred to the new system.

    (Optional) Run ROMs from your Slot-1 flashcard

    Custom box art instructions
    1. Create your .png file that's 128x115.
    2. Name the .png file to the same filename as the game, but with ".png" added to the end (ex. SD card: game.nds.png, Flashcard: game.ini.png).
    3. Save it to "sdmc:/_nds/twloader/boxart/" for games on the SD card, or "sdmc:/_nds/twloader/boxart/flashcard/" for games on the Slot-1 flashcard.

    DSi Menu theme: ROM select controls
    • Left/Right / Touch left/right game icons: Select a game/app.
    • L: Next page.
    • R: Previous page.
    • Y: Change icon size.
    • A / Touch selected icon: Launch selected game/app.
    • START: Start menu.
    • SELECT: Game settings.

    Game settings selections
    1. ARM9 CPU Speed
    2. VRAM boost
    3. Lock ARM9 SCFG_EXT
    4. Set as donor ROM: Applies an ARM7 binary from the set ROM, to the game you're running with non-working saves.
    5. Set LED color: A set color will appear in the Notification LED.

    R4 theme: menu controls
    • Left/Right: Move cursor.
    • A: Enter selected icon.
    • SELECT: Open Settings.
    R4 theme: ROM select controls
    • Up: Move up.
    • Down: Move down.
    • Left: Move up 10.
    • Right: Move down 10.
    • L: Switch game location.
    • A: Start game.
    • B: Back to menu.
    Wood theme controls
    • Up/Down: Move cursor.
    • A: Enter selection.

    Settings controls
    Settings will be saved on app exit or game/app launch.
    • L: Previous page.
    • R: Next page.
    • Y/A: Change selected setting.
    • B: Go back to ROM select screen.

    ROM play controls
    NOTe: Only for DSTT, R4i Gold, R4i-SDHC, SC DSONE, and SD card users.
    • L+R+A+B+X+Y: Start TLoZ Four Swords (USA) (if installed).

    Please check this list:
    List of games that work from SD Card


    Todo
    • Add cheat menu.
    • Load themes stored on SD Card.

    Credits
    This wouldn't have been possible without the following.

    FAQs

    Q: Is TWLoader a DS/DSi emulator?
    A: No. TWLoader is not an emulator (as stated above). When you launch a game in TWLoader, the system reboots into TWL mode, then switch to NTR mode for running your selected DS game (via the backend nds-bootstrap, if ROM is on SD card).

    Q: Why is TWLoader taking me back to HOME Menu after updating itself?
    A: Some versions of TWLoader have a bug where it always updates itself to the latest version, even if it's already on the latest version.
    To fix this, either turn off Wifi and turn off auto-update TWLoader in the settings screen, or open settings.ini, and set AUTODOWNLOAD (in [FRONTEND]) to 0.

    Q: What's the TWLNAND side CIA? Does it patch TWL_FIRM?
    A: No. It's a DSiWare apps only used by the GUI (not seen in HOME Menu). The TWLNAND side starts bootstrap for running the ROMs and certain flashcards, and part 2 runs Slot-1 games/flashcards.

    Q: Why do I get a white screen when trying to load a game from DSTT, Original R4, or the Acekard RPG?
    A: A white screen will happen sometimes. Just try again if it happens.

    Q: Why do I get a white screen when trying to load a game from SD Card?
    A: Please note that not all games work from SD Card yet. Check the list above.
    If it's listed as compatible, try again.

    Q: How do I run a game in GBARunner2?
    A: Put your SRAM-patched GBA ROM in the SD root as "runner.gba" and put the BIOS in the SD root as "bios.bin".
    To SRAM-patch your ROM, use GBATA.

    Q: Why is there lagging when picking a game?
    A: The previous/next boxart and icon images are loaded, instead of them being loaded all at once. This is done to prevent memory leaks.

    Q: Won't the LED feature cause an MCU brick?
    A: Don't worry. @MarcusD said that you can only MCU brick on firmwares 8.1 or below.
    It's confirmed there aren't any bricks above 8.1.

    Q: Why am I'm getting the error screen when launching a game?
    A1: Make sure you're using an up-to-date CFW, namely Luma3DS.
    A2: Make sure part 1 & 2 of TWLNAND side is installed to both SysNAND and EmuNAND.

    Q: Why do I get a black screen when launching a game, or "Add Games"?
    A: I dunno, but please follow this guide. https://3ds.guide/troubleshooting#twl_broken
    If you're using a boot manager to boot Luma, such as BootAnim9, look here.

    Q: Why do I get an auto-shutdown when launching a game, or "Add Games"?
    A: It's due to a pre-patched TWL_FIRM still being installed. Follow this guide. https://3ds.guide/troubleshooting#twl_broken
    If you're using a boot manager to boot Luma, such as BootAnim9, look here.

    Q: Will there be a way to return to the TWLoader menu while playing a game?
    A: Maybe or maybe not. It may require hacking TWL_FIRM, which may be hard.

    Q: How do I update TWLoader on the 3DS?
    A: To manually update, select "Update TWLoader" in TWLoader settings.

    Q: I'm getting a bootstrap not found error?
    A: In settings, update the bootstraps, then in NTR/TWL settings, set Bootstrap to Release, then to Unofficial (or vice-versa).
     
    Last edited by Robz8, Jun 21, 2017 at 1:54 AM


  2. Exavold

    Exavold GBAtemp Advanced Fan

    Member
    991
    1,027
    Nov 9, 2015
    France
    Wow, that's really nice.

    I wish I'd fully understand how to use it though
     
    Last edited by Exavold, Nov 11, 2016
  3. proflayton123

    proflayton123 just another user

    Member
    5,453
    1,902
    Jan 11, 2016
    London
    Nice work :3
     
  4. jailminer

    jailminer Joel? Are you up at 6 AM making a Custom Title?

    Member
    365
    111
    Feb 9, 2016
    United States
    Holy shit. Nice work! Will it work on o3ds?
     
  5. Robz8
    OP

    Robz8 Coolest of TWL

    Member
    5,781
    2,307
    Oct 1, 2010
    United States
    Yep.
     
    NoNAND likes this.
  6. jailminer

    jailminer Joel? Are you up at 6 AM making a Custom Title?

    Member
    365
    111
    Feb 9, 2016
    United States
    Listen. I love you and everyone here. Now I can finally play my DS games! Yeah..... my life is boring without my DS games.....

    — Posts automatically merged - Please don't double post! —

    BTW where do i store save files and roms? Can you inject saves yet? And DS Download play?
     
  7. Robz8
    OP

    Robz8 Coolest of TWL

    Member
    5,781
    2,307
    Oct 1, 2010
    United States
    Sadly, it's only homebrew and download play for now.
     
  8. jailminer

    jailminer Joel? Are you up at 6 AM making a Custom Title?

    Member
    365
    111
    Feb 9, 2016
    United States
    Ah. Good work! I didn't even think about the homebrew... I will enjoy its limitations!
     
    maorninja likes this.
  9. iAqua

    iAqua Proud Follower of Skiddon't-ism

    Member
    GBAtemp Patron
    iAqua is a Patron of GBAtemp and is helping us stay independent!

    Our Patreon
    2,261
    1,537
    Dec 7, 2015
    Canada
    We're getting there!
     
    HomebrewJay, BlastXDX and Darkyose like this.
  10. andyhappypants

    andyhappypants Advanced Member

    Newcomer
    66
    23
    Jul 27, 2012
    This is promising stuff!!

    Oct/Nov have been full of surprises :D
     
    Darkyose likes this.
  11. Robz8
    OP

    Robz8 Coolest of TWL

    Member
    5,781
    2,307
    Oct 1, 2010
    United States
    ROMs go in "sdmc:/nds".
     
  12. xtheman

    xtheman GBAtemp Guru

    Member
    5,837
    5,235
    Jan 28, 2016
    Is it possible to load forwarders with this?
     
  13. Exavold

    Exavold GBAtemp Advanced Fan

    Member
    991
    1,027
    Nov 9, 2015
    France
    So , for instance , I can play Aperture Science (Portal DS) with this ?
     
    Last edited by Exavold, Nov 11, 2016
  14. Robz8
    OP

    Robz8 Coolest of TWL

    Member
    5,781
    2,307
    Oct 1, 2010
    United States
    No, meaning DSiWare can't be launched with this.
    Yes.
     
    xtheman and Exavold like this.
  15. Exavold

    Exavold GBAtemp Advanced Fan

    Member
    991
    1,027
    Nov 9, 2015
    France
    Well appearently not , it just hangs on a white screen after DSi logo for me.
     
  16. Robz8
    OP

    Robz8 Coolest of TWL

    Member
    5,781
    2,307
    Oct 1, 2010
    United States
    Try using nds-bootstrap from @ahezard's page.
     
  17. elcampeon4000

    elcampeon4000 GBAtemp Regular

    Member
    160
    14
    Sep 13, 2016
    what is the content who i load in the nds loader?
     
  18. Robz8
    OP

    Robz8 Coolest of TWL

    Member
    5,781
    2,307
    Oct 1, 2010
    United States
    ROMs, as the file in the folder says.

    EDIT: Thought you said "folder", not "loader".
     
    Last edited by Robz8, Nov 11, 2016
  19. elcampeon4000

    elcampeon4000 GBAtemp Regular

    Member
    160
    14
    Sep 13, 2016
    don´t load the retail roms in this moment? can you give me a link for download Ds Download Play roms?
     
  20. Robz8
    OP

    Robz8 Coolest of TWL

    Member
    5,781
    2,307
    Oct 1, 2010
    United States
    They're copyrighted content, so no.