Tanuki3DS is a new HLE 3DS emulator for MacOS and Linux written in C which aims to be simple, fast, and compatible. Currently it can play a handful of games at full speed and supports some nice features like controller support and video upscaling. If you have any questions, you can join our discord server.
You need the following dependencies installed to build and run:
- sdl2
- glew
- xbyak (build only)
- xxhash (build only)
- capstone (build only)
They can all be installed with your local package manager (brew on macos, apt on ubuntu, etc).
To build use make. You can pass some options to make, USER=1 to compile a user build with lto, and DEBUG=1 for unoptimized build with debug symbols. I have tested on both Linux with gcc and MacOS with Apple clang. Currently Windows is not natively supported, but you should be able to use the emulator on Windows through WSL (Windows Subsystem for Linux).
Note for M1 Mac users: we currently only have x86 JIT backends, so you will need to install the x86 version of brew. A guide can be found here.
You can run the executable in the command line with the rom file as the argument like ./ctremu path/to/game.3ds (currently supports .elf, .3ds, .cci, .cxi files, roms must be decrypted). You can also pass -h to see other options.
The keyboard controls are as follows:
| Control | Key |
|---|---|
A |
L |
B |
K |
X |
O |
Y |
I |
L |
Q |
R |
P |
Circlepad |
WASD |
Dpad |
Arrow keys |
Start |
Return |
Select |
RShift |
| Pause/Unpause | F5 |
| Toggle speedup | Tab |
The touch screen can be used with the mouse.
You can also connect a controller prior to starting the emulator.
Many games work, but many will suffer from a range of bugs from graphical glitches to crashes. Also we don't have audio support yet. We are always looking to improve the emulator and would appreciate any bugs to reported as a github issue so they can be fixed.
- 3DBrew is the main source of documentation on the 3DS's operating system
- GBATEK is used for low level hardware documentation
- libctru and citro3d are libraries for developing homebrew software on the 3DS and are useful as documentation on the operating system and GPU respectively
- Citra, 3dmoo, and Panda3DS are HLE 3DS emulators which served as a reference at various points, as well as inspiration for this project
- citra_system_archives is used for generating system file replacements