Editing Citra

{{Infobox emulator
|logo = Citra.png
|logowidth = 153
|active = No
|platform = [[Emulators on Windows|Windows]]<br/>[[Emulators on Linux|Linux]]<br/>[[Emulators on macOS|macOS]]<br/>[[Emulators on Android|Android]]
|target = [[Nintendo 3DS emulators|Nintendo 3DS]]
|developer = [https://web.archive.org/web/20240228233903/https://github.com/citra-emu Citra Team]
|prog-lang = {{Proglang|C++}}
|website = [https://web.archive.org/web/20240304185955/https://citra-emu.org/ Citra-emu.org]
|compatibility = [https://web.archive.org/web/20240304201046/https://citra-emu.org/game/ Official List]
|source = [https://web.archive.org/web/20240304191755/https://github.com/citra-emu/citra GitHub] (archive)
|license = {{license|GPLv2}}
|bios = [[Emulator_Files#Nintendo_3DS|Required for some games and decryption]]
}}

'''[[wikipedia:Citra (emulator)|Citra]]''' (formerly Akiru) is a discontinued free and open-source [[Nintendo 3DS emulators|Nintendo 3DS]] emulator/debugger written in C++. It is also available as a [[libretro]] core. The emulator is no longer active.

==Overview==
Citra emulates a subset of 3DS hardware and therefore is useful for running/debugging homebrew applications, and it is also able to run many commercial games. Some of these do not run at a playable state. On May 23, 2020, a [https://citra-emu.org/entry/announcing-citra-android/ official Android release] for Citra came out. The minimum requirements are Android 8 (64-bit) and OpenGL ES 3.2 support. Since 15th September 2023, Citra has also added support for Vulkan, resulting in improved performance in a number of scenarios. Many games achieve playable framerates on a variety of hardware, though the developers recommend an Android device with a Snapdragon 835 chip or better.

===Discontinuation===
See [[Yuzu#Lawsuit]].

==Download==
{| cellpadding="4"
|-
|align=center|{{Icon|Win|Lin|Mac|Android}}
|''[https://web.archive.org/web/20240229205025/https://citra-emu.org/download/ Latest Archived Builds]<br>[https://web.archive.org/web/20240304191743/https://github.com/citra-emu/citra-nightly/releases Latest Archived Nightly (2104)]<br>[https://web.archive.org/web/20240304191843/https://github.com/citra-emu/citra-canary/releases Latest Archived Canary (2798)]''
|}

;We do not recommend using Citra anymore. Instead, we recommend using [[#Forks|active forks of Citra]].

==Forks==
{| class="wikitable" style="text-align:center; vertical-align:middle;"
|- style="font-weight:bold;"
! Name
! Platform(s)
! Latest version
! New 3DS
! [[#Hardware_features|Hardware features]]
! [[#Enhancements|Enhancements]]
! Compatibility
! [[Licensing|License]]
! Active
! [[Recommended Emulators|Recommended]]
|- style="font-weight:bold;"
| colspan="10" | x86
|-
| Azahar
| {{Icon|Windows|Linux|macOS}}
| {{TBD}}
| {{✓}}
| {{~}}
| {{~}}
| {{Emulator compatibility|link=https://github.com/azahar-emu/compatibility-list/issues|11|12}}
| {{Green}} {{License|GPLv2}} ({{License|Copyleft}})
| {{✓}}
| {{✓}}
|-
| PabloMK7 fork
| {{Icon|Windows|Linux|macOS}}
| [https://github.com/PabloMK7/citra/releases/tag/r608383e r608383e]
| {{✓}}
| {{~}}
| {{~}}
| ?
| {{Green}} {{License|GPLv2}} ({{License|Copyleft}})
| {{✗}}
| {{✓}}->✗ (soon)
|-
| Lime3DS
| {{Icon|Windows|Linux|macOS}}
| [https://github.com/Lime3DS/lime3ds-archive/releases/tag/2119.1 2119.1]
| {{✓}}
| {{~}}
| {{~}}
| ?
| {{Green}} {{License|GPLv2}} ({{License|Copyleft}})
| {{✗}}
| {{✓}}->✗ (soon)
|- style="font-weight:bold;"
| colspan="10" | ARM
|-
| Azahar
| {{Icon|Windows|Linux|macOS}}
| {{TBD}}
| {{✓}}
| {{~}}
| {{~}}
| {{Emulator compatibility|link=https://github.com/azahar-emu/compatibility-list/issues|11|12}}
| {{Green}} {{License|GPLv2}} ({{License|Copyleft}})
| {{✓}}
| {{✓}}
|-
| PabloMK7 fork
| {{Icon|Windows|Linux|macOS}}
| [https://github.com/PabloMK7/citra/releases/tag/r608383e r608383e]
| {{✓}}
| {{~}}
| {{~}}
| ?
| {{Green}} {{License|GPLv2}} ({{License|Copyleft}})
| {{✗}}
| {{✓}}->✗ (soon)
|-
| Lime3DS
| {{Icon|Windows|Linux|macOS}}
| [https://github.com/Lime3DS/lime3ds-archive/releases/tag/2119.1 2119.1]
| {{✓}}
| {{~}}
| {{~}}
| ?
| {{Green}} {{License|GPLv2}} ({{License|Copyleft}})
| {{✗}}
| {{✓}}->✗ (soon)
|}
{{Infobox emulator
|title = Azahar
|logo = Azahar icon.png
|logowidth = 153
|active = Yes
|version       = N/A (not yet released as binary)
|platform = [[Emulators on Windows|Windows]]<br/>[[Emulators on Linux|Linux]]<br/>[[Emulators on macOS|macOS]]<br/>[[Emulators on Android|Android]]<br/>[[Emulators on iOS|iOS]]
|target = [[Nintendo 3DS emulators|Nintendo 3DS]]
|developer = OpenSauce, PabloMK7, and other contributors
|prog-lang = {{Proglang|C++}}
|source = [https://github.com/azahar-emu/azahar GitHub]
|license = {{license|GPLv2}}
|bios = [[Emulator_Files#Nintendo_3DS|Required for some games]]
}}
{{Infobox emulator
|title = Lime3DS
|logo = Lime3DS icon.png
|logowidth = 153
|active = No
|version       = {{Version|Lime3DS}}
|platform = [[Emulators on Windows|Windows]]<br/>[[Emulators on Linux|Linux]]<br/>[[Emulators on macOS|macOS]]<br/>[[Emulators on Android|Android]]
|target = [[Nintendo 3DS emulators|Nintendo 3DS]]
|developer = OpenSauce and other contributors
|prog-lang = {{Proglang|C++}}
|source = [https://github.com/Lime3DS/Lime3DS GitHub]
|license = {{license|GPLv2}}
|bios = [[Emulator_Files#Nintendo_3DS|Required for some games and decryption]]
}}
{{Infobox emulator
|title = Citra MMJ
|logo = citrammj.jpg
|logowidth = 110
|active = Yes
|version       = [https://github.com/weihuoya/citra/releases git]
|platform = [[Emulators on Android|Android]]
|target = [[Nintendo 3DS emulators|Nintendo 3DS]]
|developer = [https://github.com/citra-emu/citra/graphs/contributors Citra Team], Weihuoya
|prog-lang = {{Proglang|C++}}
|website = 
|source = [https://github.com/weihuoya/citra GitHub]
|license = {{license|GPLv2}}
}}
{{Infobox emulator
|title = PabloMK7 fork
|logo = Citra.png
|logowidth = 153
|active = No
|version       = [https://github.com/PabloMK7/citra/releases/latest git]
|platform = [[Emulators on Windows|Windows]]<br/>[[Emulators on Linux|Linux]]<br/>[[Emulators on macOS|macOS]]<br/>[[Emulators on Android|Android]]
|target = [[Nintendo 3DS emulators|Nintendo 3DS]]
|developer = [https://github.com/PabloMK7 PabloMK7] and other contributors
|prog-lang = {{Proglang|C++}}
|source = [https://github.com/PabloMK7/citra GitHub]
|license = {{license|GPLv2}}
|bios = [[Emulator_Files#Nintendo_3DS|Required for some games and decryption]]
}}
{{Infobox emulator
|title = Borked3DS
|logo = Borked3DS.png
|logowidth = 153
|active = Yes
|version       = [https://github.com/Borked3DS/Borked3DS/releases/latest git]
|platform = [[Emulators on Windows|Windows]]<br/>[[Emulators on Linux|Linux]]<br/>[[Emulators on macOS|macOS]]<br/>[[Emulators on Android|Android]]
|target = [[Nintendo 3DS emulators|Nintendo 3DS]]
|developer = [https://github.com/rtiangha rtiangha]
|prog-lang = {{Proglang|C++}}
|source = [https://github.com/Borked3DS/Borked3DS GitHub]
|license = {{license|GPLv2}}
|bios = [[Emulator_Files#Nintendo_3DS|Required for some games and decryption]]
}}
;Azahar: A merger of the PabloMK7 and Lime3DS Citra forks by the same developers, meant to merge added features of both to make a definitive emulator. Certain changes made out of legal considerations were announced such as ending support for encrypted games and renaming the .3ds file format to its official file extension, .cci. Cryptographic keys are now included in the emulator directly.<ref>{{cite web |last= |first=PabloMK7 |date=December 12, 2024 |title=Game Loading on Azahar: What's Changing |url=https://azahar-emu.org/blog/game-loading-changes/ |website=azahar-emu.org |location= |publisher= |access-date=January 25, 2025}}</ref>

;Borked3DS: A rebrand and continuation of the Bravely Offline Citra fork. It has all of the latest features from PabloMK7's Citra fork, incorporating most features from Lime3DS, and some hacks and features from Mandarine, as well as having its own features.

;PabloMK7 fork: A Citra fork written in C++ and initially created to add online play,<ref>https://twitter.com/Pablomf6/status/1719705943028449372</ref> but continued to receive new updates and other new features following the end of support for upstream Citra. PabloMK7 was a contributor of Citra, and the repository has also seen work from other active Citra contributors such as GPUCode, who was among the most active contributors before the repository was deleted. Being a fork of Citra, the emulator emulates a subset of 3DS hardware and therefore is useful for running/debugging homebrew applications; it is also able to run many commercial games. Some of these do not run in a playable state. On May 5, 2024, PabloMK7 announced an upcoming feature known as Artic Base,<ref>https://twitter.com/Pablomf6/status/1787246255002853480</ref> released on May 12, 2024.<ref>https://github.com/PabloMK7/ArticBaseServer</ref> Artic Base is a 3DS homebrew app that can stream game data from the 3DS system to an instance of Citra over the local network, allowing users to play their own games on Citra without having to dump them. Artic Base can also sync save data between the 3DS and Citra. Development of the fork ceased on October 29, 2024, pending a merger with Lime3DS (which had also ceased development). The resulting Citra fork would later come to be known as Azahar.<ref name="azahar">https://azahar-emu.org</ref>

;Citra MMJ: '''Citra MMJ''' is a unofficial [[Nintendo 3DS emulators|Nintendo 3DS]] emulator for Android written by weihuoya and forked from [[Citra]]. Offers less stuttering and greater performance than mainline Citra on Android, along with additional features. Minimum hardware requirements for this fork are not defined, although games should run more quickly on weaker hardware than mainline requires.

;Folium: A Citra port to iOS/iPadOS devices developed by Jarrod Norwell. Previously known as emuThreeDS and [https://github.com/emuPlace/Limon/ Limón]. Now continued as a [[Multi-system_emulators|multi emulator]] named Folium. [https://github.com/folium-app/Cytrus Cytrus] is the Nintendo 3DS emulation core used in Folium.[https://x.com/antique_codes/status/1845758124298481883/photo/2]

;Lime3DS: A Citra fork. The main goal of the project was to act as a revival of Citra.<ref>https://github.com/Lime3DS#lime3ds-is-a-project-which-aims-to-revive-citra-the-most-popular-open-source-nintendo-3ds-emulator</ref> Much like its predecessor, Lime3DS is mainly written in C++. Development for Lime3DS began on the same day as Citra's closure, March 4, 2024. Unlike some other forks appearing at this time, the developers for Lime3DS intended to separate their branding from that of Citra and create a separate successor. The emulator had been steadily updated since then, boasting high compatibility and stability for many 3DS titles. Development ceased in November 2024, pending a merger with the PabloMK7 Citra fork (which had also ceased development). The resulting Citra fork would later come to be known as Azahar.<ref name="azahar"></ref>

;Mandarine: A Citra fork. It was originally named as "Citra-Enhanced." Development ceased temporarily in March 2024 due to the [[Yuzu#Lawsuit|stoppage of Citra development]]. Afterward, the project changed its name to Lemonade<ref>https://old.reddit.com/r/EmulationOnAndroid/comments/1bbos29/citraenhanced_is_going_to_be_continued_and/</ref> and shifted its focus to the Android platform while planning to add new [[Nintendo_3DS_emulators#Hardware_features|features]] and [[Nintendo_3DS_emulators#Enhancements|enhancements]]. However, due to critique stemming from Lemonade's developers alleged stealing of code from other forks, violation of Citra's GPL license, and berating of developers of other forks,<ref>https://web.archive.org/web/20240411140255/https://twitter.com/Pablomf6/status/1778376166098825515</ref> much of the team has since abandoned the project.<ref>https://github.com/Lemonade-emu/Lemonade/pull/2/files#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5R16</ref> The fork was thereafter renamed back to Citra-Enhanced, before then renaming again to Mandarine after an alleged repository hijack attempt.<ref>https://github.com/mandarine3ds/mandarine/commit/ad06b079df3641e1f4086278ef93a65c204d245c#contribution</ref>

==Shared data==
Some 3DS games make use of shared files from the console's system software. These games will not boot in Citra if said files are not present in the user folder.

These files are not provided by the Citra developers for legal reasons, so they can be downloaded from the [[Emulator Files#Nintendo 3DS|Emulator Files]] page.

==Importing saves==
Some games require this to bypass bugs in title screens.
# Get the Title ID for the game version you have from [http://www.3dsdb.com/ here]. For example, we'll try with the European version of Zelda: ALBW. Its full Title ID is <code>00040000000EC400</code>.
# Take the last 8 digits of the Title ID. (in our example, <code>000EC400</code>) In case this method fails later, take <code>00000000</code> instead, or make sure the save file and the ROM image are from the same region.
# Make an empty folder named as that partial Title ID (<code>000EC400</code>). Put inside it another folder named "data", then inside that one put another folder named <code>00000001</code>, then inside that one put the actual save data files.
# Move the folder with the title ID and put it here:
#: <code>\user\sdmc\Nintendo 3DS\00000000000000000000000000000000\00000000000000000000000000000000\title\00040000</code>

==Issues==
===Emulation issues===
Emulation for various features is non-existent or not actively worked on enough to be in a usable state. This includes:
* Connectivity features relying on Wi-Fi (Wii U/3DS, Switch/3DS, 3DS Local Multiplayer, 3DS Online...), not in small part due to the setbacks hindering Wi-Fi DS emulation. However, Download Play is emulated.
* New 3DS mode. It is now in a playable state, but some games may still crash with it enabled.

===Game image format===
Citra accepts games in '''.3ds, .cia or .cxi format'''. Furthermore, in Summer 2017, chances are your existing dumps tailor-made for Citra most probably made with the officially recommended tool braindump, which were missing some data yet could be emulated on Citra, have had their compatibility broken as a design choice with no options provided to fix those dumps. You'll have to get new dumps.

While the latest sighax exploit allows for dumping decryption keys to convert (and possibly load) encrypted games in either .3ds or .cia format, development for a solution to allow for this Citra, even one requiring keys from your console, was formerly not actively pursued ''as a design choice''. Tools on 3DS and PC exist to convert those to decrypted .3ds format, and a guide can be found [[Nintendo 3DS emulators#Encryption|here]]. However, Citra now allows loading/installing encrypted 3ds/CIA files if the necessary AES keys are provided. The required keys are provided with the 3DS Shared Data downloadable above.

===Telemetry===
Citra developers decided to implement a telemetry feature, uploading to them through Internet connection detailed logs and data about your computer specs and the games you're playing. When booting Citra for the first time, you get asked if you want to enable it.

===macOS compatibility===
Although macOS support in Citra is still poor, macOS builds have returned to Citra Canary 2485 and newer thanks to the addition of the new Vulkan renderer. Previously, macOS builds were discontinued after build 1782 due to the developers raising the OpenGL requirements to version 4.3, while macOS only supports up to version 4.1. The new Vulkan renderer addresses this by utilizing the MoltenVK translation layer instead of OpenGL, enabling compatibility with macOS systems. Additionally, these latest builds are Universal and have native support for both Intel and Apple Silicon.

==Issues with downloading==
If you decide to install it from the archived link, The updater tries to fetch for updates and cant fetch any due to it shutting down forcing you to quit the setup

However, you can download Citra from "Manual Installation" section and you can download and use Citra as usual.

==External links==
* [https://web.archive.org/web/20240304201046/https://citra-emu.org/game/ Official compatibility list]
* [https://web.archive.org/web/20240304193125/https://community.citra-emu.org/ Official Citra forum]

[[Category:Emulators]]
[[Category:Console emulators]]
[[Category:Handheld console emulators]]
[[Category:Nintendo 3DS emulators]]
[[Category:Windows emulation software]]
[[Category:Linux emulation software]]
[[Category:macOS emulation software]]
[[Category:Android emulation software]]
[[Category:Inactive emulation software]]