More actions
| braindump | |
|---|---|
| File:Braindump.jpeg | |
| General | |
| Author | neobrain |
| Type | System Tools |
| Version | 1 |
| Last Updated | 2015/12/30 |
| Links | |
| Download | |
| Website | |
| Source | |
Braindump is a 3DS homebrew application that can dump 3DS titles, i.e. cartridge and eShop games, but also other installed content. Since it runs entirely in userland, it runs on any system version supported by the Homebrew Launcher.
The dumps created by braindump are lossy, since not all title information is accessible to userland applications. braindump compensates for that by generating fake metadata using clever heuristics. This is good enough to be able to run the dumped title in an emulator or to title contents (artwork, sounds, etc) for ROM hacking. If you require an (almost) lossless copy of your title, it's recommended to use uncart instead.
WHAT IS IT USEFUL FOR?
braindump can be used both for dumping games for use in an emulator as well as dumping game contents for game modding.
braindump's feature set has been covered by Uncart 3DS and Decrypt9 3DS before, however braindump provides a few major advantages:
- it runs on any system version newer than 9.0, including the most recent one. uncard and Decrypt9 are limited to system versions 9.2 or below (currently).
- it dumps cartridge games, eShop content, and (some) system applications in a uniform way. All three of these had to be decrypted with different commands before.
- it's more convenient, since it can be launched directly from the Homebrew Launcher and only requires one operation step from starting to the decrypted content. uncart and Decrypt9 had to be launched through a separate program, and after dumping a game you had to restart your console and run another chain of commands to actually decrypt things.
Build Instructions and Setup
You need to have set up a 3DS homebrewdevelopment environment including devkitARM and ctrulib. If you're having trouble building or running braindump, make sure your toolchain is up to date. Once you've setup braindump, you can build it by calling
make
in the project root directory. If all went well, you then should have files braindump.3dsx, braindump.xml, and braindump.smdh. Put these onto your SD card into the directory 3ds/braindump/. When running braindump from the Homebrew Launcher, you will be prompted to select a "target title". Once you select a title, it will be dumped without any further confirmation to the the SD card root directory using the filename <titleid>.cxi (where titleid is a 16-digit identifier of the dumped title).
Frequently Asked Questions
What stuff can I dump with this?
- In general, most 3DS games should be dumpable, regardless of whether physical (cartridge) or digital (eShop).
- Recent 3DS games which use the 9.6-crypto cannot be dumped and probably won't ever be dumpable via braindump.
- Non-game content (videos, system applications, ...) should be dumpable if they have a "proper" title. Some applications (e.g. Home Menu) only provide dummy titles and hence cannot be dumped currently.
- GBA or DS games cannot be dumped, at least for now.
- Virtual Console games using software emulation are untested. Chances are they are dumpable. If the application you're trying to dump is not supported, it will likely outright crash when trying to launch braindump. In particular, if the title doesn't boot with HANS, it likely won't work with braindump either. There currently is no way for braindump to fail more gracefully, unfortunately.
How to use braindump for ROM hacking?
At this stage, I cannot give you full instructions on how to mod a game, but here are some quick hints:
- Launching
- Dumping the game contents using braindump on your 3DS. This will place the file
<titleid>.cxion your SD card. - To extract the game content you have to extract the ExeFS and the RomFS. You can do this on a PC using ctrtool with the commands
ctrtool --exefs=exefs.bin --decompresscode <titleid>.cxiandctrtool --romfs=romfs.bin <titleid>.cxi; ctrtool --romfsdir=romfs --intype=romfs romfs.bin, respectively. - Game modders will be interested in the contents extracted to romfsdir. Modify whatever you like, and repack the contents using a tool like 3dstool.
- Put the new romfs binary on your SD card. Start HANS on your 3DS and point it to the modded game, and make it replace the romfs with your new image.
I tried this but it keeps getting stuck at "Dumping code... XYZ KiB"
It's so slooooow.. why?!
Be patient. Dumping ExeFS may take up to 5 minutes per MiB, depending on how well the 3DS plays with your SD card (it's unfortunately not possible to show a progress bar for this, contrary to RomFS dumping). RomFS dumping should be going at roughly 1 MiB/s.
Can I use the dumps with Citra?
Yes! Note that this has not been tested extensively though. If you come across a title which runs fine in Citra when dumped using uncart but not when dumped using braindump, please report an issue.
Will you add FTP support to dump directly over network???
Maybe. Pull requests are welcome!
Will this break my 3DS?
It runs entirely in userspace, hence it's unlikely anything bad will happen. Of course, I cannot give you any guarantee for this though; I take no responsibility for anything that happens as a direct or indirect consequence of running this software on your 3DS.
Credits
Creating braindump wouldn't have been possible if it hadn't been for the help and support of the 3DS community. My greatest thanks go to the whole 0xFOODDOODs 32c3 table for an awesome time, and in particular to smea for his repeated advice and patience.