Editing Citra

Jump to navigation Jump to search

Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision Your text
Line 1: Line 1:
 
{{Infobox emulator
 
{{Infobox emulator
|logo = Citra.png
+
|logo = citra.svg
|logowidth = 153
+
|logowidth = 150
|active = No
+
|active = Yes
|platform = [[Emulators on Windows|Windows]]<br/>[[Emulators on Linux|Linux]]<br/>[[Emulators on macOS|macOS]]<br/>[[Emulators on Android|Android]]
+
|platform = Windows, Linux, macOS
 
|target = [[Nintendo 3DS emulators|Nintendo 3DS]]
 
|target = [[Nintendo 3DS emulators|Nintendo 3DS]]
|developer = [https://web.archive.org/web/20240228233903/https://github.com/citra-emu Citra Team]
+
|developer = [https://github.com/citra-emu/citra/graphs/contributors Citra Team]
|prog-lang = C++
+
|website = [http://citra-emu.org/ Citra-emu.org]
|website = [https://web.archive.org/web/20240304185955/https://citra-emu.org/ Citra-emu.org]
+
|support = [https://www.patreon.com/citraemu Patreon]
|compatibility = [https://web.archive.org/web/20240304201046/https://citra-emu.org/game/ Official List]
+
|source = [https://github.com/citra-emu/citra/ GitHub]
|source = [https://web.archive.org/web/20240304191755/https://github.com/citra-emu/citra GitHub] (archive)
 
|license = GNU GPLv2
 
|bios = [[Emulator_Files#Nintendo_3DS|Required for some games and decryption]]
 
 
}}
 
}}
 +
'''Citra''' is an experimental, open-source [[Nintendo 3DS emulators|Nintendo 3DS]] emulator/debugger written in C++. It's currently able to run quite a few games well, though very few can run at full speed on existing hardware, and most titles have sound issues.
  
'''[[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. While the emulator is no longer active, a fork maintained by PabloMK7 is still active.
+
Due to its preliminary state, it has not yet had a stable release.
  
==Overview==
+
==Downloads==
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.
+
* [https://citra-emu.org/download/ Latest nightly and canary]
 
 
===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)]'''
 
|}
 
 
 
;Also see [[Citra (PabloMK7 fork)|PabloMK7]], [[Citra MMJ]], [[Nintendo_3DS_emulators#Comparisons|Limón]], [[Nintendo_3DS_emulators#Emulators|rinsuki]] and [[Nintendo_3DS_emulators#Comparisons|Citra-Enhanced]] forks.
 
  
 
==Shared data==
 
==Shared data==
Line 47: Line 33:
 
===Emulation issues===
 
===Emulation issues===
 
Emulation for various features is non-existent or not actively worked on enough to be in a usable state. This includes:
 
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.
+
* 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.
* New 3DS mode. It is now in a playable state, but some games may still crash with it enabled.
+
* New 3DS mode. Throws a fatal error or tries to emulate in old 3DS mode. Even when the source is modified to allow for New 3DS mode, it's still too buggy and crash-prone to be usable.
 +
* Stereoscopic 3D visual effect. Was worked on briefly before being abandoned.
  
===Game image format===
+
===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.
 
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.
+
Furthermore, 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, isn't actively pursued ''as a design choice''. Tools on 3DS and PC exist to convert those to decrypted .3ds format for the time being, and a guide can be found [[Nintendo 3DS emulators#Encryption|here]].
  
 
===Telemetry===
 
===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.
+
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.
 +
 
 +
==Playing Citra on your phone==
 +
[https://github.com/uberhalit/CitraTouchControl This] program allows you to control Citra with touch controls on your phone.
 +
It is, therefore, possible to use a [https://play.google.com/store/apps/details?id=com.microsoft.rdc.android.beta remote desktop client] via your phone, to emulate with Citra and stream from your PC to your phone.
 +
See gif.
  
===macOS compatibility===
+
[[File:Citra_Remote.gif|thumb|right|Example of remote phone play on Citra. (Click to play)]]
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==
+
An [https://github.com/SachinVin/citra_android unofficial frontend software] for running Citra on Android devices has been created by SachinVin, and its first binary release came out on [https://github.com/SachinVin/citra_android/releases/tag/v0.1.0-pre-alpha May 23, 2018]. It was based off the Dolphin frontend for Android. It is in continuous development with newer releases as of late 2018. It is slow and possibly with no sound, and its compatibility level is low.
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
 
  
 
==External links==
 
==External links==
* [https://web.archive.org/web/20240304201046/https://citra-emu.org/game/ Official compatibility list]
+
* [https://citra-emu.org/game/ Official compatibility list]
* [https://web.archive.org/web/20240304193125/https://community.citra-emu.org/ Official Citra forum]
+
* [https://www.ziperto.com/nintendo/3ds-roms/decrypted-3ds-roms/ Playable Decrypted ROM's Collection]
 +
* [https://citra-emu.org/discord/ Discord channel]
 +
* [https://community.citra-emu.org/ Official Citra forum]
 +
* [https://www.youtube.com/channel/UC_dcdgzuapBtAY4ol3x-90Q Official YouTube channel]
  
 +
[[Category:Nintendo 3DS emulators]]
 
[[Category:Emulators]]
 
[[Category:Emulators]]
[[Category:Console emulators]]
 
[[Category:Handheld console emulators]]
 
[[Category:Nintendo 3DS emulators]]
 
 
[[Category:Windows emulation software]]
 
[[Category:Windows emulation software]]
 
[[Category:Linux emulation software]]
 
[[Category:Linux emulation software]]
 
[[Category:macOS emulation software]]
 
[[Category:macOS emulation software]]
[[Category:Android emulation software]]
 
[[Category:Inactive emulation software]]
 

Please note that all contributions to Emulation General Wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see Emulation General Wiki:Copyrights for details). Do not submit copyrighted work without permission!

To edit this page, please answer the question that appears below (more info):

Cancel Editing help (opens in new window)