Repository files navigation

3DS.py is a WIP port of thePython 3.6.9 interpreter to the Nintendo 3DS.It allows you to run your Python scripts directly on the 3DS by having the interpreterembedded into a homebrew application that launches amain.py script from the samedirectory.

Just grab one of the releasesover here and unzip it. Copy the entire3DS.pyfolder to the3ds directory of your SD card and navigate into it. You shouldsee a3DS.py.3dsx application.

The same directory also contains the entire Python standard library and amain.py file.To run your own projects, copy all source files into the3DS.py directory and "start"your application from within themain.py file as this is the entry point to any Pythonhomebrew.

If you want to compile from source, it is required to set up adevkitARM development environment first. Next, you need toinstall the zlib portlib by running(dkp-)pacman -S 3ds-zlib. Otherwiseyou will get linker errors for the zlib module. Thencd into the 3DS.pydirectory and runmake to build the binaries and a statically linked Pythonlibrary with the corresponding header files for building Python C modules.

If you're on macOS, make sure to have gnu-sed installed.brew install gnu-sed

A list of cool homebrew projects that make use of 3DS.py.Want yours to be listed here? PR them.

Need help? Or want to have an active voice in development of and around this project?Then join ourDiscord guild which focusses on homebrew development for theNintendo 3DS in Python.

This way, things can be discussed more directly and you'll likely get answfers to yourquestions faster than through GitHub issues.

In no particular order, I want to credit these amazing people fortheir contributions.

• 3DBrew for their extensive documentation and research pertainingto the 3DS.

• devkitPro for their devkitARM toolchain.

• smea for thectrulib project.

• David Buchanan for troubleshooting assistance.

• Fenrir for his support and thectru-rs projectthat helped me out with the condition variables implementation.

• Richard Caseres for the awesome app icon he designed.