This repository has been archived on 2022-05-31. You can view files and clone it, but cannot push or open issues or pull requests.
Luma3DS-3GX/README.md

41 lines
1.8 KiB
Markdown
Raw Normal View History

2016-04-23 01:43:11 +02:00
# Luma3DS
*Noob-proof (N)3DS "Custom Firmware"*
2015-08-05 09:04:13 +02:00
2016-09-06 16:41:37 +02:00
## What it is
2015-08-05 04:22:30 +02:00
2016-09-06 16:41:37 +02:00
**Luma3DS** is a program to patch the system software of (New) Nintendo 3DS handheld consoles "on the fly", adding features (such as per-game language settings and debugging capabilities for developers) and removing restrictions enforced by Nintendo (such as the region lock).
It also allows you to run unauthorized ("homebrew") content by removing signature checks.
2018-03-31 16:29:25 +02:00
To use it, you will need a console capable of running homebrew software on the ARM9 processor. We recommend [Plailect's guide](https://3ds.hacks.guide/) for details on how to get your system ready.
2016-09-06 16:41:37 +02:00
2017-06-05 16:15:49 +02:00
Since Luma3DS v8.0, Luma3DS has its own in-game menu, triggerable by `L+Down+Select` (see the [release notes](https://github.com/AuroraWright/Luma3DS/releases/tag/v8.0)).
2016-09-06 16:41:37 +02:00
---
## Compiling
2017-05-29 17:41:17 +02:00
First you need to clone the repository with: `git clone https://github.com/AuroraWright/Luma3DS.git`
2017-05-23 17:41:19 +02:00
To compile, you'll need [armips](https://github.com/Kingcom/armips) and a build of a recent commit of [makerom](https://github.com/profi200/Project_CTR) added to your PATH. You'll also need to install [firmtool](https://github.com/TuxSH/firmtool), its README contains installation instructions.
You'll also need to update your [libctru](https://github.com/smealum/ctrulib) install, building from the latest commit.
Here are [Windows](https://buildbot.orphis.net/armips/) and [Linux](https://ev1l0rd.s-ul.eu/mEIk4atQ) builds of armips (thanks to who compiled them!).
Run `make` and everything should work!
2016-09-06 16:41:37 +02:00
You can find the compiled files in the `out` folder.
---
2015-08-05 04:30:38 +02:00
2016-09-06 16:41:37 +02:00
## Setup / Usage / Features
2016-03-29 18:17:22 +02:00
2016-04-23 01:43:11 +02:00
See https://github.com/AuroraWright/Luma3DS/wiki
2015-08-05 12:45:22 +02:00
2016-09-06 16:41:37 +02:00
---
## Credits
2016-04-24 20:12:58 +02:00
See https://github.com/AuroraWright/Luma3DS/wiki/Credits
2016-09-06 16:41:37 +02:00
---
## Licensing
2016-04-24 20:12:58 +02:00
This software is licensed under the terms of the GPLv3.
2016-05-06 17:18:01 +02:00
You can find a copy of the license in the LICENSE.txt file.