3DS-Linux
---------

It's Linux(R) on the 3DS(TM), but it's even more modern, and works well!
What works and works well:
- Booting
  - Booting properly to a TTY on original 3DS consoles (2DS and 3DS XL too)
  - Booting from the Luma3DS custom firmware
- Hardware
  - RAM : all 128MB of FCRAM are usable
  - Using VRAM to store the framebuffers in RGB565, allowing all RAM to be usable by linux
  - SD Cards
  - Virtual keyboard on the bottom touch screen
  - Graphics output on the top display in 400x240, using either the Linux VT, or anything that writes to /dev/fb0 (e.g. Xorg)
  - Battery status reporting
  - Circlepad input as mouse movement
  - Gamepad buttons exposed as GPIO
  - Notification LED (unused but support is present)
  - Internal STMicroelectronics LIS331DLH accelerometer
- App support
  - Most applications that you would want to use - anything in Void Linux officially
  - X11 Windowing system - lightweight Window Managers / Desktop Environements will work

What works if you ignore the obvious problems:
- Powering off the console from linux (kernel panics right before powering off)

What doesn't work at all:
- WiFi (no support for the actual wifi chip, documentation is quite scarce, but support is planned)
- Sound
- Booting from Horizon OS (no way to get complete hardware control once HOS starts)

What isn't tested:
- Booting on New 3DS consoles (New 3DS XL and New 2DS XL too) - I dont have any, if you would like to test and give feedback, contact me

Links
-----
- Downloads page  Get all of the files here!
- Installation Guide
- User Guide

Developers
-----------
- "ToyotaAE86Trueno"
  - Lead project organiser
  - Tester (o3DS)
  - Gives Support
  - Part of the current kernel development
  - Website administrator
  - Got most of everything after 5.11-RC1 working

- "Techflash"
  - Developer
  - Tester (o3DS)
  - Got Linux 7.1 working the day it released
  - Wii-Linux project maintainer

Special thanks
---------------
- "Wolfvak"
  - Previously the main kernel developer
  - Got kernel 5.11-rc1 working
  - Active member of the 3DS homebrew community

- The Void Linux team
  - Developement of Void Linux - the primary linux distribution for 3DS-Linux
  - Still caring about ARMv6 devices in 2026

- "Sunday-PB450G3"
  - One of my many old laptops, and the website and downloads server for this site
  - Didnt explode when i installed nginx
  - Runs Arch BTW

This site is proudly written in basic HTML and near-zero CSS

(C) Copyright 2026-2026 ToyotaAE86Trueno. Some rights reserved
See legal disclaimers, privacy policy, copyright, and trademark notices