• Stars
    star
    1,179
  • Rank 39,665 (Top 0.8 %)
  • Language
    C
  • License
    GNU General Publi...
  • Created about 8 years ago
  • Updated about 1 month ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Boot an nds file


GBAtemp thread Discord server: #nds-bootstrap Build status on GitHub Actions Localization status on Crowdin

nds-bootstrap is an open-source application that allows Nintendo DS/DSi ROMs and homebrew to be natively utilised rather than using an emulator. nds-bootstrap works on Nintendo DSi/3DS SD cards through CFW and on Nintendo DS through flashcards.

ROM Compatibility

nds-bootstrap supports most DS/DSi ROMs, with a few exceptions. You can enhance your gaming experience with cheats and faster load times than general cartridges (for games that support those features). Game saving is supported too and will be saved in the .sav extention, and .pub or .prv for DSiWare. If you find a bug, please report it in the issues tab. ROM compatibility is recorded in the compatibility list.

Anti-Piracy patches can be loaded via IPS files, but they are not included inside the software itself.

nds-bootstrap also supports many homebrew applications, including games like DScraft.

B4DS mode (a result of running nds-bootstrap on DS-mode flashcards with locked SCFG or DS Phat/Lite) only supports some DS and DSiWare ROMs. You can increase compatibility by inserting a DS Memory Expansion Pak.

Compiling

If your goal is to get a build of the latest commit, you can download that from our TWLBot Builds repository. Also, if you push your commits to a GitHub fork, you can have GitHub Actions run on every commit that way. If, however, you'd like to compile locally, you will need to install devkitARM with the necessary Nintendo DS development libraries.

  1. Install devkitPro's pacman package manager as described on the devkitPro wiki, then run the following command to install the needed libraries:
    sudo dkp-pacman -S nds-dev
    
    (Note: Command will vary by OS, sudo may not be needed and it may be just pacman instead)
  2. Clone this repository using git (git clone https://github.com/DS-Homebrew/nds-bootstrap.git) and navigate to the cloned repo
  3. Compile lzss.c to a directory in your PATH using a C compiler such as GCC (gcc lzss.c -o /usr/local/bin/lzss)
    • On Windows it must instead be lzss.exe in the root of the repository
  4. Run make package-nightly to compile nds-bootstrap
    • The output files will be in the bin folder

If you need help compiling, please ask for help in our Discord server or a GitHub Discussion.

Frontends

A frontend isn't required as nds-bootstrap uses an ini file to load its parameters. However, it is very much recommended.

TWiLight Menu++

TWiLight Menu++ is a frontend for nds-bootstrap, developed by Rocket Robz & co. It has 6 customizable launchers to choose from with the ability to launch emulators and other homebrew.

It also includes a number of Anti-Piracy patches for the games and will automatically configure nds-bootstrap for you, with customizable per game settings.

Forwarders

Allows you to run games directly from the DSi Menu or 3DS HOME Menu. Some compatibility features from TWiLight Menu++ are missing in forwarders so if you have issues you may need to edit the per-game settings by holding Y while loading the forwarder.

YANBF (Yet Another nds-bootstrap Forwarder)

An alternative forwarder generator for 3DS users. YANBF forwarders are 3DS-mode applications so they count towards the normal 300 title limit insted of the smaller 40 title limit on DSi-mode applications, however they cannot have animated icons and take slightly longer to load.

Credits

Developers

  • Rocket Robz: Lead developer, DSi mode and DSiWare support, B4DS mode, general maintenance and updates
  • shutterbug2000: SDK5 support, help with DSi mode support, and some other implemented stuff
  • ahezard: Starting the project, former lead developer
  • Pk11: In-game menu, screenshot taking, manual loading, and translation management
  • Gericom: Improving B4DS compatibility

Other

Translators

More Repositories

1

TWiLightMenu

DSi Menu replacement for DS/DSi/3DS/2DS
C++
3,227
star
2

GodMode9i

GodMode9i Explorer - A full access file browser for the Nintendo DS and DSi consoles :godmode:
C
479
star
3

flashcard-archive

An archive of all the firmwares for Nintendo DS flashcards
Roff
274
star
4

twlmenu-extras

This is the repository where extra files for TWiLight Menu++ are hosted
Python
122
star
5

wiki

Wikis for DS-Homebrew projects
HTML
42
star
6

Flashcard-Firmware-Archive

33
star
7

dsbf_dump

NDS BIOS + Firmware dumper
C
28
star
8

NesDS

NesDS1.3c
C
27
star
9

twilight-manual

The manual for TWiLight Menu++
TypeScript
25
star
10

DLDI

An archive of flashcard DLDI drivers and source codes
C
21
star
11

PicoDriveTWL

SEGA Genesis/Mega Drive emulator for the Nintendo DS(i)
Assembly
14
star
12

vnds

C
12
star
13

libslim

libelm revival using FatFs 0.14 with libfat compatible API
C
11
star
14

TWLHelper

DS⁽ⁱ⁾ Mode Hacking Discord server bot
Python
9
star
15

TWL-ROM-Optimize

Makes DSiWare ROMs slightly smaller
C
9
star
16

ds-homebrew.com

A page to redirect to the actual DS-Homebrew websites
HTML
8
star
17

DSi-Exclusive-Template

A template for DSi-Exclusive homebrew
Makefile
8
star
18

DS-CPUSpeedCheck

Checks the DS(i)/3DS console for NTR or TWL Clock speed
Makefile
7
star
19

ChroniclesDX

Changes made to Sonic Chronicles: The Dark Brotherhood, with RomFS being injected programatically.
7
star
20

PokeMini

C
7
star
21

StellaDS

Atari 2600 emulator for DS (original code by AlekMaul)
C++
6
star
22

libndsi

C library for Nintendo DS(i) – forked from devkitPro/libnds
C
6
star
23

DSiRAMCheck

Checks for issues with DSi RAM
Makefile
5
star
24

flashcard-archive-web

HTML
4
star
25

Super-Mario-War

Super Mario War is a Super Mario deathmatch game. The goal is to stomp as many other Marios as possible.
C++
4
star
26

nds-bootstrap-extras

This is the repository where extra files for nds-bootstrap are hosted
Python
3
star
27

shaberusoft-logging

Documenting ShaberuSoft's development files. All can be launched on TWiLight Menu++'s latest update!
2
star
28

lmp-ng-2

Music player for the Nintendo DS
Objective-C
1
star