Wikis

_Sidebar

Home Users: FAQ Legacy Builds User Directory Citra Web Service Compatibility List Android user data Installing FFmpeg Dumping guides: AES keys Game cartridges Installed titles Updates and DLCs Save data Extra data Config savegame System archives General: Contributing Donating Developers: Developer information Common issues Building Citra: Windows macOS Linux Android OpenBSD 3DS CPU 3DS documentation 3DS tests LLE library applet Log filters APK signing in Bitrise Issue labels Stack trace guide Typical Git workflow

Continue Reading

AES Keys

How to obtain AES Keys Users can provide some additional crypto keys to enable some advanced features in Citra. These keys are not officially provided by Citra due to legal considerations. Automatically (Recommended) In this method, you will create aes_keys.txt and seeddb.bin files from your console using a GodMode9 script. This will dump all the keys and other secrets you need for game decryption, Miis, amiibo, etc. This requires your 3DS to be on firmware 11.

Continue Reading

Archive of 3DS Documentation

For better or worse, there is no unified way of writing and collecting information gathered during research on 3DS software or hardware. This page hence seeks to gather a list of various places for 3DS documentation. A wiki dedicated to 3DS reverse-engineering fincs’s notes on various PICA200 features: Procedural texture generation, shadow mapping, gaseous rendering mike’s transcript of the gaseous rendering patent wwylele’s diagram of gaseous rendering based on the said patent Subv’s notes on the kernel scheduler implementation

Continue Reading

Archive of 3DS Tests

For better or worse, there is no unified way of writing and collecting tests written against 3DS software or hardware. This page hence seeks to gather a list of various repositories of 3DS tests. Note: When adding to the list, if there are any prerequisites for a test outside of simply setting up a working devkitPro environment, please be sure to state them somewhere. Citra’s official test suite aroulin’s tests

Continue Reading

Building for Android

Dependencies Android Studio NDK and CMake Git Cloning Citra with Git git clone --recursive https://github.com/citra-emu/citra.git Citra by default will be cloned into - C:\Users\\citra on Windows ~/citra on Linux And wherever on macOS Building Start Android Studio, on the startup dialog select Open. Navigate to the citra/src/android directory and click on OK. In Build > Select Build Variant, select release or relWithDebInfo as the “Active build variant”. Build the project with Build > Make Project or run it on an Android device with Run > Run 'app'.

Continue Reading

Building for Linux

An unofficial PKGBUILD of Citra is available for Arch Linux on the AUR. Dependencies: You’ll need to download and install the following to build Citra: SDL2 Deb: sudo apt install libsdl2-dev Arch: pacman -S sdl2 Fedora: sudo dnf install SDL2-devel OpenSUSE: zypper in libSDL2-devel OpenSSL (optional) Deb: sudo apt install libssl-dev Arch: pacman -S openssl-1.0 Fedora: sudo dnf install openssl-devel OpenSUSE: zypper in openssl-devel Qt 6.2+ Only 6.2+ versions are tested.

Continue Reading

Building for macOS

Dependencies: It’s recommended that you use homebrew to install dependencies. You’ll need to download and install the following to build Citra: CMake (brew install cmake) glslang (brew install glslang) A recent version of Xcode and the Xcode command line tools Cloning Citra in Git: git clone --recursive https://github.com/citra-emu/citra cd citra Using CMake: Create a build folder and generate makefiles for the build: mkdir build cd build cmake .. Building Citra make -j4 A citra-qt.

Continue Reading

Building for OpenBSD

OpenBSD is not officially supported. These instructions are not actively updated and represent what happened to work for one user on amd64 in March 2018. Install the required packages: (Please amend if you notice some are missing, I did not test this on a clean installation!) pkg_add cmake sdl2 qtbase The repository uses submodules, so remember to clone it recursively: git clone --recursive https://github.com/citra-emu/citra cd citra To build, run the following in the repository root directory:

Continue Reading

Building for Windows

MSVC Build for Windows Minimal Dependencies On Windows, all library dependencies are automatically included within the “externals” folder or can be downloaded on-demand. To build Citra, you simply need to install: Visual Studio 2022 - Make sure to select C++ support in the installer. CMake - Used to generate Visual Studio project files. Vulkan SDK - Make sure to select Latest SDK. Git - We recommend Git for Windows. While installing Git Bash, you should tell it to include Git in your system path.

Continue Reading

Citra Android user data and storage

Citra’s user data storage on Citra Android Beta 16+ is a bit more complicated than it used to be. This is due to Google mandating that all Android apps need to use SAF (Safe Access Storage) moving forward. How to set up your Citra user data folder Click to expand: Updating from an older Citra version After installing a recent Citra build, you’ll be greeted by a pop-up to set up a user data folder.

Continue Reading