What is Citra?

Citra is a work-in-progress Nintendo 3DS emulator started in early 2014. Citra can currently emulate, with varying degrees of success, a wide variety of different homebrew applications and commercial software.

What is Citra’s License?

Citra is an open-source project, licensed under the GPLv2 (or any later version). Refer to the license document for more information.

Who made Citra?

Citra has an active team of open-source developers. Over 50 people have worked hard on the project since its founding in 2014! The list of contributors can be found on GitHub.

Note: Citra is not affiliated with Nintendo in any way.

Where does the name come from?

The name is derived from CTR, which is part of the model number of the original 3DS.

Running games in Citra

When launching a game, I get a “Could not Determine System Mode” or “Failed to Decrypt” error. I want to run backups of retail titles that I own, how can I do that?

Citra does not natively run dumps of games that have not been appropriately decrypted. This requires a physical 3DS and the game you own. Refer to:

Can Citra run Pokémon games?

Most Pokémon games work properly, but Pokémon X/Y is still currently unplayable. (We don’t know why yet)

The ones that do work might require System Archives dump.

If the console prints the following error log, then the System Archives dump is missing.

Debug.Emulated  core\hle\svc.cpp:SVC::Break:466: Break reason: PANIC

Debug.Emulated  core\hle\svc.cpp:SVC::Break:450: Emulated program broke execution!

Can Citra run [Insert retail game name here]?

Citra can, ostensibly, “play” many different games now and more will become playable as development progress further. Some games/apps, however, will not load at all – only showing a black screen. Others, might just display the title screen and then freeze or crash.

Does Citra support WiFi, network connectivity or online play?

Yes, Citra supports networked local WiFi but does not recommend connecting to Nintendo’s servers.

Are you planning to make an Android version?

No, not at the moment.

Does Citra have controller support?

Yes; however, it is not configurable via the GUI at the moment. Please refer to this forum post for the temporary solution.

Note: Citra now supports controller configuration via the GUI. Please use the latest build.

Can I expect Citra to play [GAME] at full-speed?

Citra can run most games at full speed now thanks to the recent JIT compiler being merged into the official build. Certain parts of videos/cutscenes will still be slower due to JIT compilation not being feature complete yet. However, not all games are created equally, and therefore some games will run at full speed while others might suffer from slow emulation.

Note: The speed of [GAME] will depend on the single-core performance of your processor. Refer to your CPU benchmark in this graph. If it’s below a score of 1,800 the [GAME] might not be playable at decent speeds.

Also, it has been reported that using the integrated Intel GPU has shown significant performance increased in emulation speed. Only some games will benefit from it. This also applies to other emulators as well. Feel free to test both integrated and dedicated GPU to see which one gives you the best performance.

[GAME] runs way too fast, how can I slow down the emulation?

Recent versions have a framerate limiter built-in. It can be toggled in the configuration, reachable through the Menu (Citra-qt): “Emulation” > “Configure…” > “Graphics” > “Limit Framerate”. You may also want to enable V-Sync on the same page if desired.

I saw a YouTube video about [GAME], why doesn’t it work on the nightly build?

Alternative custom branches may not have been merged into master. We only support nightly builds based on the master branch. Unofficial builds are not supported. There may be other branches that are planned to be merged but must go through vetting first to ensure they are useful contributions to the project long term.

Where can I download games to use with Citra?

Short answer: You don’t. Buy games and dump them with a Nintendo 3DS.