Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/roxas75/rxtools

rxTools
https://github.com/roxas75/rxtools

Last synced: 3 months ago
JSON representation

rxTools

Awesome Lists containing this project

README 

        
# rxTools - Roxas75 3DS Toolkit



[![Join the chat at https://gitter.im/roxas75/rxTools](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/roxas75/rxTools?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)



[Official twitter account](https://twitter.com/RxTools)



rxTools is a collection of hacking tools for Nintendo 3DS/3DSXL/2DS, compatible with all the system versions from 4.1 to 9.2.



rxMode is a free custom firmware which works through rxTools, not meant to replace any existing software, but just my personal

work made public and easy for the end-user.



It was not meant, at the beginning, to be open-source, so you can expect some messed up code here.



I do not support piracy in any way, all the data and information in my software have already been made public.



## Current functionality

### General

- Support for Web Browser (SPIDER) entrypoint for Old 3DS (ver 4.1-9.2)

- Support for System Settings (MSET) entrypoint for Old 3DS (ver 4.1-4.5, 6.0-6.4, and 9.2 with MSET downgraded to 6.x)

- Support for System Settings (MSET) downgrading for Old 3DS

- Support for Ninjhax (Not Stable)

- Hacking tools collection



### rxMode

- Support for the latest emuNAND version on Old 3DS and New 3DS (you currently need key_0x16.bin and key_0x1B.bin for N3DS)

- Support for sysNAND, in case an emuNAND is not found

- Access to the eShop and to online playing (requires an updated emuNAND)

- Support for 100% of the games (newer ones will require emuNAND)

- Signatures Checks disabled, which should allow just homebrew, but the world is cruel...

- Support for installing FBI (a CIA Manager) in both emuNAND and sysNAND

- Support for AGB (GBA Virtual Console) on both sysNAND and emuNAND on Old 3DS

- Support for TWL (DS/DSi cartridges and DSiWare) **only on sysNAND**

- Dynamic RAM dumping (just for debug purposes)



## Nightlies

Nightly builds of rxTools are a thing, again! :D https://lavanoid.github.io/



## How to build



Requirements for Windows:

- git, clone this repository with the following command: *git  clone --recursive https://github.com/roxas75/rxTools.git*

- [devkitPRO](http://sourceforge.net/projects/devkitpro) with devkitARM option and suboptions installed

- [ImageMagick](http://www.imagemagick.org)

- [Python 2.7](https://www.python.org) non needed for build, only for auxiliary tools



Requirements for GNU/Linux:

- [git](https://apps.ubuntu.com/cat/applications/git/), clone this repository with the following command: *git  clone --recursive https://github.com/roxas75/rxTools.git*

- [devkitPRO and devkitARM](http://3dbrew.org/wiki/Setting_up_Development_Environment) (follow the tutorial for Linux)

- [ImageMagick](http://www.imagemagick.org) (on Debian/Ubuntu, [install it using apt](https://apps.ubuntu.com/cat/applications/imagemagick/))



In case make.exe fails with stack trace dump, install [GnuWin Make](http://gnuwin32.sourceforge.net) and place it in path before devkitPRO/msys/bin



If you get the *make: Interrupt/Exception caught (code = 0xc00000fd, addr = 0x4227d3)* error on Windows, look at your PATH and move any path with parenthesis to the end of it



Requires ImageMagick >= 6.8.9 - If you are using Ubuntu 14.04 or below, do not use the version in the official repositories, as it is outdated



Just run **make release** and rxTools/sys directory should be generated in the **release** folder, along with all the other packets, then copy the contents of the release folder to the root of your SD card.  



Make sure that the path to rxTools doesn't include space (' ').



## Setting up rxTools  

- If you have used a previous version, please delete SD:/rxTools, SD:/3ds/rxTools, and rxTools.dat, if present on your (m)SD card.  

- Extract the rxTools folder from the release and place it into the root of your card.

- If you are using an Old 3DS or 2DS, ensure you have Python 2.7 installed on your PC and run /Tools/o3ds_cdn_firm.py. This should download 3 files into a folder named /firm. Copy this entire folder and place it into SD:/rxTools/.

- If you are using an New 3DS, ensure you have Python 2.7 installed on your PC and run /Tools/n3ds_cdn_firm.py. This should download 1 file into a folder named /firm. Copy this entire folder and place it into SD:/rxTools/. You also need the files key_0x16.bin (N3DS arm9bin decryption, 9.6+ keyX) and key_0x1B.bin (N3DS 9.6 NCCH keyX) on the root of your SD card.

- For use with the Homebrew Launcher, go into the ninjhax folder and copy the /rxTools folder to SD:/3ds/  

  



## How to launch with Spider

rxTools *now* stores its code.bin in rxTools/sys/code.bin (formerly /rxTools.dat). To launch rxTools using the Spider exploit visit https://dukesrg.github.io/?rxTools/sys/code.bin using the 3DS Internet Browser. (Requires ver 9.2 or older).



## How to install DS Profile (MSET) Exploit (requires MSET 6.x)

Upon building, there will be a folder called release/mset that contains the files rxinstaller.nds and rxinstaller.bin. Using a supported NDS flash cart, launch rxinstaller.nds to install the MSET exploit. Otherwise, on firmwares 9.2 or older, copy rxinstaller.bin (take it in release/mset/) to SD:/mset/, and visit https://dukesrg.github.io/?mset/rxinstaller.bin to install the MSET exploit via the Spider exploit. If it worked, you'll see the bottom screen flash, and then the browser will appear to continue functioning normally. Press the home button, and after you see the Home Menu splash screen your DS will say "an error occurred" and ask you to reboot, but it's already done. You can then launch rxTools by going to Settings -> Profile -> DS Profile Settings.

Alternatively, you can install the MSET ROP with FBI. Press select and use left and right on the D-pad to select "rxTools3.x 4.x" or "rxTools3.x 6.x", depending on the version of MSET you are using. 

* Do NOT install 4.x MSET on a 2ds. Formatting in this configuration will cause a soft brick!



## Credits

- All the documentation on http://3dbrew.org, and to all the devs who contributed

- Roxas75, myself, as the creator of rxTools

- Gateway team, for their work

- Reisyukaku for New 3DS MSET

- Archshift, who wrote some useful libs I used: https://github.com/archshift

- Many GBATemp users, who helped in the testing process

- patois, who developed BRAHMA: https://github.com/patois/Brahma

- mid-kid and b1l1s, who developed CakeHax: https://github.com/mid-kid/CakeHax

- Steveice10, ApacheThunder and TuxSH for most TWL patches

- Many other people who helped me in private

- All the dudes who reversed and fucked up my project, who wasted their time on making useless keeping the sources private



##License

###rxTools

Copyright (C) 2015 The PASTA Team



This program is free software; you can redistribute it and/or

modify it under the terms of the GNU General Public License

version 2 as published by the Free Software Foundation



This program is distributed in the hope that it will be useful,

but WITHOUT ANY WARRANTY; without even the implied warranty of

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

GNU General Public License for more details.



See LICENSE for the details.



###CakeHax

The Source Code Form is subject to the terms of the Mozilla Public

License, v. 2.0.



See CakeHax/LICENSE.txt for the details.



###CakesROP

CakesROP is licensed by zoogie, mid-kid, bilis, and Reisyukaku

under the BSD 2-clause license.



See CakesROP/LICENSE for the details.



###PolarSSL

Copyright (C) 2006-2010, Brainspark B.V.



The program is free software; you can redistribute it and/or

modify it under the terms of the GNU General Public License

version 2 as published by the Free Software Foundation



The program is distributed in the hope that it will be useful,

but WITHOUT ANY WARRANTY; without even the implied warranty of

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

GNU General Public License for more details.



See LICENSE for the details.



###JSMN

Copyright (c) 2010 Serge A. Zaitsev



The software is licensed under MIT License.



See LICENSE_JSMN for the details.



### Support the original, not the imitation!