Checkpoint
Fast and simple homebrew save management framework for 3DS and Switch.
- 3.1k
- C++
- GPL-3.0
- 6 wk ago
Stock iOS 4.2.1 running natively on the Old Nintendo 3DS ARM11
Repo devilAPI/ios3ds, read from GitHub 1 h ago. devilAPI has not joined Take My Repo.
devilAPI/ios3ds is a public repo on GitHub by devilAPI. Stock iOS 4.2.1 running natively on the Old Nintendo 3DS ARM11. It declares the GPL-3.0 license on GitHub. It is written mainly in C, has 29 stars and last changed on 2026-11-21. Nobody has reviewed it on Take My Repo yet, which says nothing about its quality. Read from GitHub on 2026-11-22.
In the maintainer's words. Shown from GitHub; Take My Repo does not keep a copy.
Apple's real iOS 4.2.1 running natively on a Nintendo 3DS.
Not an emulator: the iPod touch 2G's own kernel, SpringBoard and apps run directly on the 3DS's ARM11 CPU.
Install · Controls · What works · Troubleshooting · How it works · Build from source
iOS boots to the home screen in about a minute. Apps open, Safari loads web pages over Wi-Fi, and Cydia comes pre-installed.
| Feature | Notes | |
|---|---|---|
| ✅ | Boot to the home screen, built-in apps | about a minute from power-on |
| ✅ | Touchscreen, HOME, POWER, START/SELECT, L/R | see Controls; slide to unlock and popups over apps work |
| ✅ | Graphics on the 3DS GPU (PICA200) | the iOS interface is drawn by the GPU |
| ✅ | Sound, volume slider | speaker |
| ✅ | Battery level, charging, date and time, brightness | through the 3DS system controller |
| ✅ | Wi-Fi: scan, WPA2, also routers in "WPA2 + WPA3" mode | needs the console's own Wi-Fi firmware, copied automatically by the launcher (or the GodMode9 script); stays connected through the router's key renewals |
| ✅ | Safari | loads pages; big pages can fail with "Cannot allocate memory" (a retry usually works), being worked on |
| ✅ | Cydia | pre-installed, on the first home screen page |
| ✅ | Screen rotation (accelerometer) | |
| ✅ | D-pad, circle pad | turned 90° to match the upright iOS screen: ← → pages, ↑ ↓ and the stick scroll |
| ✅ | Cameras (Camera.app, back and front, photos) | 320×240 live preview, about 12 fps; photos go to the Camera Roll. No video recording or 3D photos. Confirmed on an Old 3DS and a New 2DS XL |
| 🧪 | Microphone | recording works in the emulator; Voice Memos records Apple Lossless (playback fixed after 0.4.0, 🧪) |
| ⚠️ | Headphone jack | iOS switches to headphones when plugged in, but 0.4.0 was silent in them; CODEC fix after 0.4.0 not yet confirmed, see docs/audio.md §4 |
| 🧪 | Music app: a test song and your own songs | install.py --music DIR (or files in SD/ios3ds/music/): .mp3, .m4a (AAC/ALAC), .wav, .aif; docs/audio.md §10 |
| 🧪 | Gyroscope (CoreMotion) | |
| 🧪 | Fake GPS location (CoreLocation) | set with boot.cfg gps= or /usr/bin/ios3ds-gps from a terminal; 1 Hz updates in apps, including Safari, see docs/location.md |
| 🧪 | Modern HTTPS: TLS 1.2/1.3 (TLSFix), current root certificates | Cydia and other unsandboxed apps; not yet Safari, see Limitations |
| 🧪 | Cydia Substrate (tweaks) | pre-installed; installing tweaks no longer hangs the 3DS; tweaks load into SpringBoard and apps, see docs/cydia.md |
| 🧪 | New 3DS: 804 MHz CPU, C-stick, ZL/ZR | L2 cache optional, see docs/n3ds.md |
| ❌ | 3D screen, IR, NFC, video recording | currently unplanned |
✅ works on a real 3DS · ⚠️ works on a real 3DS with known problems · 🧪 works in the emulator, not yet confirmed on a console · ❌ not working / not supported
| Console | Status |
|---|---|
| Old 3DS | ✅ supported, the main test console |
| Old 3DS XL | ✅ boots to the home screen (#7; release 0.3.0 could panic in the accelerometer driver right after boot, fixed in main) |
| Old 2DS | ✅ supported (same hardware as the Old 3DS) |
| New 2DS XL | ✅ boots to the home screen with sound, power button, battery, Wi-Fi and cameras (#1, #5) |
| New 3DS, New 3DS XL | untested; expected to behave like the New 2DS XL. On New models ios3ds runs the CPU at 804 MHz; the extra CPU cores and RAM are not used |
All models need Luma3DS (boot9strap). Reports for any model are welcome in the issues.
You need about 15 minutes, a PC and your own copy of the iPod touch firmware. Nothing is installed to the 3DS itself; everything lives on the SD card.
A 3DS with Luma3DS (boot9strap) and the Homebrew Launcher, set up the usual way (3ds.hacks.guide).
An SD card with about 1.2 GB free.
A PC with Python 3.8+ and internet access, needed once to fetch the firmware keys and Cydia:
| System | Setup |
|---|---|
| Linux | sudo apt install python3 python3-cryptography |
| macOS | Python 3, pip3 install cryptography, xcode-select --install |
| Windows | use WSL (Ubuntu) and follow the Linux steps; the SD card is /mnt/<letter> |
ios3ds-<version>.zip from the Releases page. Unzip it anywhere.iPod2,1_4.2.1_8C148_Restore.ipsw, the iPod touch 2nd generation on iOS 4.2.1, from Apple's servers via ipsw.me.Put the SD card in your PC, open a terminal in the unzipped folder and run:
python3 install.py ~/Downloads/iPod2,1_4.2.1_8C148_Restore.ipsw /media/$USER/YOUR_SD_CARD
Use your own paths. The card is /Volumes/NAME on macOS and /mnt/e (or another letter) in WSL.
It takes a few minutes and needs about 4 GB of free space on the PC while it works. It:
--no-cydia to skip it) and TLSFix (3.2 MB from GitHub; --no-tlsfix to skip it);| On the SD card | What it is |
|---|---|
3ds/ios3ds.3dsx |
the app you start from the Homebrew Launcher |
luma/payloads/ios3ds.firm |
the same, for Luma's chainloader menu |
ios3ds/ |
iOS itself (rootfs.hfs, 1 GB), the patched kernel, and boot.cfg (settings) |
Without an SD card path, the files go to ios3ds-sd/. Copy what is inside that folder to the root of the card.
Updating: re-running the installer on a card that already has ios3ds replaces the iOS disk but carries your data (Wi-Fi networks and passwords, settings, photos, voice memos, preferences, SpringBoard layout) over from the previous
rootfs.hfs. Installed Cydia packages and the Music library are not carried over. Add--freshto discard everything and start clean;--backup-oldkeeps arootfs.hfs.bakcopy of the previous disk. If the data does not fit or any file fails to copy, the previous disk is kept assd:/ios3ds/rootfs.hfs.bakautomatically and you get a warning.
Open the Homebrew Launcher, start ios3ds and press A. The 3DS reboots into iOS.
Alternatively, hold START while powering on and pick ios3ds in Luma's chainloader menu.
First start:
Wi-Fi firmware: reading NWM .code ..., writes one file, ios3ds/nwm.code, and skips this step afterwards.SD ok, ARM11 ok and a short countdown. Hold B to stop there.Wi-Fi: in iOS, open Settings → Wi-Fi and pick your network.
If the launcher showed a red
Wi-Fi fw: ...line, copy the firmware once with GodMode9 instead:
- Hold START while powering on and choose GodMode9.
- Press HOME →
Scripts...→ios3ds-wifi-fw, then confirm with A.Details: docs/wifi.md §3.
| 3DS | iOS |
|---|---|
| Touchscreen | tap, swipe, type |
| HOME or START | Home button |
| POWER (press) or SELECT | lock / sleep |
| L / R | volume down / up |
| Circle pad | scroll (in the direction of the upright iOS screen) |
| D-pad | with the 3DS turned so iOS is upright: ← → previous / next page, ↑ ↓ scroll by about a page |
| X | screen layout: iOS on top + touch copy below → iOS on the bottom only → iOS on top only |
| C-stick (New 3DS) | like the D-pad: flick ← → = previous / next page, ↑ ↓ = scroll by about a page |
| ZL / ZR (New 3DS) | scroll to the top / screenshot |
| POWER (hold ~10 s) | leave iOS: the 3DS switches off; the next power-on is your normal Luma + HOME Menu |
| SELECT + START (hold) | debugging only: crash iOS on purpose and write a report to the log |
ios3ds never writes to the 3DS's internal memory (NAND) or firmware. It has no code that could. It only reads and writes files on the SD card.
A homebrew app can't start another system directly, so the launcher swaps files on the SD card and reboots:
ios3ds/swap.flg, a "swap in progress" note.boot.firm (Luma) to ios3ds/luma.firm.ios3ds/ios3ds.firm to boot.firm.The first thing ios3ds does is undo this, so Luma is back as boot.firm before iOS even starts. These are renames, never copies, so a power cut can't leave a half-written boot.firm. If it ever stops halfway:
boot.firm in its internal storage (set up by the 3ds.hacks.guide);ios3ds/luma.firm;ios3ds/luma.firm back to boot.firm on a PC.As with any homebrew, back up your SD card first. More: docs/real-hardware.md.
Logs: every boot writes sd:/ios3ds/log.txt, and the previous one is kept as log_prev.txt. Please open an issue and attach log.txt.
Settings: they live in sd:/ios3ds/boot.cfg, a text file. Useful switches:
| Switch | Effect |
|---|---|
gpu=0 |
don't use the 3DS GPU at all: try this first if the screen stays black or garbled |
ca_gpu=0 |
draw the iOS interface in software (slower) |
screen=0/1/2 |
start in screen layout top / both / bottom |
camera=0, gyro=0, hp_route=0 |
turn off the cameras, the gyroscope, or headphone switching |
gps=52.5200,13.4050 |
report a fake location to apps (latitude,longitude[,accuracy in metres]); empty = off |
diag=1 |
extra diagnostics in the log |
The iPod has no GPS, so Maps and geolocation in Safari get no fix by default.
Add gps=LAT,LON (optionally ,ACC) to boot.cfg, or run
ios3ds-gps set LAT LON [ACC] / ios3ds-gps show / ios3ds-gps off in a Cydia
terminal or over SSH. That sets a 1 Hz CoreLocation fix in apps without
rebooting; details and limits: docs/location.md.
boot.cfg; the old one is kept as boot.cfg.old. The installer refuses a card with a leftover ios3ds/luma.firm: start ios3ds once, or restore Luma first.sd:/ios3ds/rootfs.hfs. Use --fresh to start clean, --backup-old to keep an extra copy of the old disk. Developer builds are different: make sd / make sdimg never carry data from the last build (QEMU images stay reproducible); opt in with make sd CARRY_FROM=/path/to/old/rootfs.hfs. Caches, logs, transient *.sqlite-journal/*.lock files, installed Cydia packages and the Music library (Media/iTunes_Control, rebuilt from ios3ds/music and the test song) are not carried. If anything fails, the old image is kept as sd:/ios3ds/rootfs.hfs.bak and a warning is printed.ios3ds/, 3ds/ios3ds.3dsx and luma/payloads/ios3ds.firm from the card.--no-tlsfix. Safari and App Store apps run in Apple's sandbox, which keeps Cydia Substrate (and so TLSFix) out, so by default they still speak TLS 1.0 only (GitHub, Wikipedia, apple.com, … don't open there). A kernel patch can relax the sandbox (make sd SANDBOX=1), but then Safari runs out of memory loading TLSFix on the 128 MB device, so it is off by default (docs/cydia.md). Sites with expired or untrusted certificates are refused everywhere./etc/launchd.conf at boot).--fresh (installer) to start with a clean disk.3DS boot (Luma3DS chainloader)
├─ ARM9 our "monitor": both screens' consoles, SD card, the iOS root disk (served from rootfs.hfs),
│ Wi-Fi (AR6014 driver + WPA2), system controller, cameras, gyro, screen copy
└─ ARM11 Apple's XNU kernel, stock, + binary patches (kernel/patches.json) + our "shim"
├─ timers, interrupts, console → mapped onto the 3DS's MPCore
├─ display → Apple's own LCD driver on a fake register page; the PICA200 GPU copies to the LCDs
├─ audio, touch, buttons, battery, Wi-Fi … → mailboxes to the ARM9
└─ launchd → configd, mediaserverd, … → SpringBoard → your apps
Apple's kernel believes it is running on an iPod touch. Where the 3DS hardware differs, small patches and the shim translate. The ARM9 handles everything slow or Nintendo-specific. Full picture: docs/architecture.md.
The project has its own QEMU machine (-M nintendo3ds, docs/emulator.md) that models the 3DS hardware, from the GPU to Wi-Fi, cameras and gyro. Every change is tested there before it reaches a console. Citra/Azahar only emulate 3DS apps; they can run the launcher but not ios3ds itself.
Linux. Requirements: Python 3 with cryptography, an arm-none-eabi toolchain (Arm GNU Toolchain or devkitARM), mtools, dosfstools, sfdisk, git. The iOS toolchain builds ldid, which needs OpenSSL 3 headers; on systems with OpenSSL 4 also install OpenSSL 3 (the script finds /usr/include/openssl-3 and similar).
make toolchain # check the tools
make fwprep IPSW=~/iPod2,1_4.2.1_8C148_Restore.ipsw # decrypt kernel, device tree, rootfs -> build/staging
scripts/build-hfsplus.sh # HFS+ image editor (xpwn)
scripts/build-ios-toolchain.sh # armv6 iOS toolchain for our iOS programs (once)
make userland # our iOS programs -> build/rootfs-add/
make sd # SD card tree -> build/sd/ (copy its contents to the card)
make test # offline unit tests
Optional:
make qemu builds the emulator, about 10 minutes.make emu boots build/sd.img in it.make launcher builds ios3ds.3dsx and needs devkitARM + libctru.make release builds the release zip (docs/release.md).No Apple files in this repository. You supply the IPSW, and everything Apple-derived is generated into build/ (gitignored). The patch recipes hold only addresses and the few original bytes needed to check that the right firmware is being patched.
| architecture.md | boot chain, memory map, every hardware bridge |
| real-hardware.md | testing safely on a console |
| emulator.md | the QEMU nintendo3ds machine, Azahar |
| gpu.md · pica200.md | OpenGL ES engine, CoreAnimation and the screen copy on the PICA200 |
| audio.md | speaker, headphones, microphone |
| mcu.md | battery, clock, buttons, sliders, accelerometer, gyroscope |
| wifi.md · certificates.md | Wi-Fi driver, WPA2, iOS integration; HTTPS roots |
| camera.md | cameras in Camera.app |
| input-design.md | touch, buttons, circle pad |
| cydia.md | the pre-installed Cydia |
| location.md | fake GPS location: boot key, runtime tool, CoreLocation hooks |
| re-log.md | the reverse-engineering log, step by step |
| hwlogs/ | logs from real hardware runs |
GPL-3.0-or-later (LICENSE), with these exceptions:
boot/arm9/sdmmc.c and emu/qemu/ are GPL-2.0-or-later.boot/arm9/fatfs/ is under FatFs's 1-clause BSD licence.boot/common/font8x8_basic.h is public domain.Downloaded during install, never shipped in the release zip: Cydia and its base packages and Cydia Substrate (Jay Freeman, from apt.saurik.com), and TLSFix 1.3 (ObscureMosquito/TLSFix, fork of nfzerox/TLSFix; it contains OpenSSL 1.1.1w, under the OpenSSL and SSLeay licences), under this licence:
MIT License
Copyright (c) 2026 nfzerox
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
iOS, iPod and XNU are trademarks of Apple; Nintendo 3DS is a trademark of Nintendo. This is an independent research project, not affiliated with either.
devilAPI/ios3ds is a public repo on GitHub by devilAPI. Stock iOS 4.2.1 running natively on the Old Nintendo 3DS ARM11.
It declares the GPL-3.0 license on GitHub.
Its maker has not tagged a system, so it is unknown here. Its README says what it needs.
Open "Take it" on its page: Take My Repo writes an install plan for your machine and hands it to your AI agent (Claude Code, Codex or Cursor), which asks you before each step. Take My Repo has not tested it on any machine.
Its last change on GitHub was on 2026-11-21. Take My Repo does not judge from that whether it is maintained.
Nobody has reviewed it on Take My Repo yet, which says nothing about its quality.
Fast and simple homebrew save management framework for 3DS and Switch.

Flutter makes it easy and fast to build beautiful apps for mobile and beyond
f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.

A theme and boot splash manager for the Nintendo 3DS console
Turn any website into an Android app (APK) – free & open source. Builds and signs the APK right in your browser, no Android Studio needed. Web, Android, iOS, Windows, macOS, Linux.
A simple HTML file that downloads Ableton Installers from their official Servers.
This is the official SoundCloud Xbox app, archived. (Ad-free version, not modified)
Reverse-engineered keygen from epc_kg22.exe — reimplemented in Python
The Linkvertise Bypasser is... What it is! It Bypasses Ad-Shorteners like Linkvertise, Adf.ly, Sub2Unlock and Gestyy with ease and without ads!
This page is also available as structured data, with the same sources and dates.
/api/v1/resources/gh/devilAPI/ios3dsTake My Repo has not tested this on your machine. Requirements come from the project's own documentation.