Papermanzero commented on Mar 18, 2018. Currently the necessary system files are located in the user directoy of the OS. However citra shoulf behave like ppsspp which uses the systems folder within the retroarch directory for bios files/user files. Mar 14, 2019 Citra Home Folder Download Citra Home Folder Dump Download Free Included in this guide are instructions on how to dump various files from a 3DS console to put into the Citra user directory.
The 3DS games on our site are from various regions such as EUR/USA/Japan. To enjoy them you just have to download the desired game from our 3DS games catalogue and unzip it, then transfer it to your R4 card or Citra games folder. Save our 3DSISO page in your favorites or remember to find us in the search engines by one of these terms: 3ds cias. Half life black ops female.
The below wiki article is based on user submitted content.
Please verify all hyperlinks and terminal commands below!
The User Directory
Citra’s user directory is where the emulator persists the emulated 3DS NAND, save data, extra data, and a host of other files necessary for Citra to run properly. The path of the user directory varies on different systems:
Home Citra – 3DS Emulator and Debugger. Citra is an open-source Nintendo 3DS emulator/debugger written in C. Citra’s features include better visual output, debugging homebrew, and controller support. The Citra repositories are hosted on GitHub. Citra is licensed under GPLv2 (or any later version). Refer to the license.txt file included. Pokemon X Main File for Citra (After receiving a beginner. Travel Details: Pokemon X Main File for Citra (After receiving a beginner) 3DS - Homebrew Probably doesn't have a 3DS, how are you able to run Pokemon X without the home folder dump? It's just that sometimes i want to experiment.
- on Windows, the path is
C:/Users/[your-user-name]/AppData/Roaming/Citra/. Note that the folderAppDatais hidden by default, so you need to change the configuration to view it.- in old version of Citra, the user directory used to be the
userfolder in the same directory as the Citra executable.
- in old version of Citra, the user directory used to be the
- on macOS and Linux, the path is
~/.local/share/citra-emu/. Note that the folder.localis hidden on most machines, so you need to change the configuration to view it. Additionally, theconfigfolder is located in~/.config/citra-emu/.
There are at least three directories within the user directory: config, nand, and sdmc. See below for details about each directory and what data is stored within.
Diagram of Citra’s User Directory
Dumping files from a 3DS
Included in this guide are instructions on how to dump various files from a 3DS console to put into the Citra user directory. These files are optional in terms of Citra’s ability to run, but depending on certain circumstances some may be required in order to run a particular game or get past a certain point in the game. In general, dumping files from a 3DS will require an SD card reader or some way to use wireless file transfer from a 3DS to a computer and that the 3DS being dumped from has Homebrew Launcher access. More advanced users will also have custom firmware and Decrypt9WIP installed to their 3DS.
If the below articles are too wordy, consult the below tutorials for obtaining optional files to improve the Citra experience:
config
This directory contains files containing information that tell Citra how to run. These files are in plain text and thus are fully editable and contain configurations for mapping controls, which [CPU]] and audio engine to use, rendering and other visual options, the [Log Filters, which region the emulated 3DS belongs to, whether to treat the emulated 3DS as a new 3DS, and whether to insert a virtual SD card into the emulated system.
Changing these files is only to be done by advanced users because making changes at random can cause Citra not to work as expected or at all. The Citra executable has options menus that allow users to change most of the aforementioned configurations safely. If Citra has trouble running after changing a file and the user cannot remember what they changed, delete the configuration files and run the executable again so that they are regenerated automatically (albeit as though Citra is being run for the first time so any existing configurations are lost).
log
This directory contains citra_log.txt. This file is automatically generated by Citra and stores the logging. It is overwritten every time Citra is launched.
nand
This directory is the emulated 3DS system NAND. It does not match an actual console’s NAND exactly due to differences between Citra and a physical 3DS. This directory will contain the data directory and potentially also the system archives.
data
This directory is automatically generated by Citra and contains the system and extra data for the emulated NAND. Inside this directory is another directory, 00000000000000000000000000000000. On a physical 3DS, the directory inside data would be named differently. Its name would be 32 characters long and made of hexadecimal characters (0-9 and A-F) instead of it being all 0’s like Citra. This knowledge is only important if you plan on dumping any NAND system data or extra data from a physical 3DS and associating it with Citra. The 00000000000000000000000000000000 contains two folders, extdata, containing NAND extra data, and sysdata, containing NAND system save data.
sysdata
System save data is identified by a title ID, separated into TID High, the first 8 characters of the title ID, and TID Low, the last 8 characters of the title ID. Most system save data has a TID high of 00000000. An individual piece of system save data is stored in sysdata/[TID Low]/[TID High]. For details about the different kinds of system save data, see 3dbrew. For first-time Citra users, there may be nothing inside the sysdata directory. In fact this will be the case for most Citra users, and is nothing to be alarmed about. This data will be created automatically in some cases, such as when a Mii is saved in Mii Maker. Almost none of this data is essential for Citra to run homebrew games or backups of licensed titles.
There is one notable exception to the last statement. Citra requires a dump of a physical 3DS’s config savegame in order to run a small number of games. Follow the instructions located at Dumping Config Savegame from a 3DS Console to obtain the config savegame from a 3DS console.
Other system save data aside from the config savegame can be dumped from a 3DS console by an expert user and placed in the sysdata folder. At this time, though, many features that read from or write to system save data have not been implemented so there is currently little value in doing so. See this discussion topic for more details about dumping system save data.
extdata
NAND extra data always has a TID High of 00048000, so the extdata directory should contain a 00048000 folder, though it has been observed in Citra that there may be a 00000000 folder instead, and users have reported issues if there is both a 00000000 and 00048000 folder contained therein, so it is advised to delete the 00000000 folder if that is the case. Inside the folder may be nothing, or it may contain one or more directories named F000000#, where # can be the characters A-F or the numbers 0-9. Each of these folders corresponds to a TID low, which can be used to identify the type of extra data stored therein. See 3dbrew for details about the different kinds of extra data stored in NAND.
At this point in time, it is possible to dump extra data from a physical 3DS’s NAND using a save manager like JKSM and to place it in the extdata directory, but doing so is entirely optional and Citra does not currently emulate NAND features that utilize most of this extra data.
system archives
This folder, named 00000000000000000000000000000000, will only exist if the system archives have been dumped from a physical 3DS. The system archives are required for some games to work with Citra. To obtain the system archives, follow the instructions located at Dumping System Archives and the Shared Fonts from a 3DS Console.
sdmc
This directory is the equivalent of the SD card inserted into a physical 3DS, which stores game save, extra data and any titles installed to the SD card in encrypted format. Inside the sdmc folder, just like on a real 3DS console, is a Nintendo 3DS directory, which contains two more directories, Private and 00000000000000000000000000000000.
Private
The Private directory on a real 3DS contains camera data (in 00020400/phtcache.bin) and sound data (in 00020500/voice/..). Citra will create camera data while it is running. If a user wants to copy their camera and sound data to Citra, they can do so easily by copying the Private folder from their SD card and overwriting Citra’s, but at this time there is no value in doing so.
00000000000000000000000000000000
This directory contains another directory of the same name, and inside of that is where game saves (in the title directory) and extra data (in the extdata directory) can be found. On a real SD card, there would not be two 00000000000000000000000000000000 folders, but instead the folders would be named as hexadecimal characters corresponding to a 3DS console ID. If a user wishes to extract save or extra data from their physical console, they do not need to worry about the console ID not matching Citra’s 00000000000000000000000000000000 folders.
title
If any games have been saved while playing them with Citra, there should be a folder inside sysdata named 00040000. This folder contains all of the save data for 3DS titles. It is entirely possible to retrieve save data from an SD card using a physical 3DS console and import it into Citra to continue a game where it was last left off on the console. See [Dumping Save Data from a 3DS Console]] for instructions. On a real SD card, the sysdata folder will also contain the files required to run any 3DS titles installed to the SD card. This can be mimicked somewhat by [Dumping Installed Titles and importing them into Citra’s sysdata directory but this is unnecessary since Citra can run them from anywhere on a computer filesystem and doesn’t require the accompanying .tmd and .cmd files.
On a real SD card, there may be two other directories inside sysdata. These directories are named 0004000e and 0004008c and correspond to downloaded game updates and DLC respectively. The data contained within these directories can be backed up on a computer as decrypted CIA files and installed with Citra (Dumping Updates and DLCs). The latest version of GodMode9 is required to redump your DLCs if you do not own all them as it was dumped incorrectly before.
extdata
This directory contains all of the extra data created when playing 3DS game backups. Citra emulates a console’s behavior of reading from and writing to extra data, so this data can be dumped from an SD card using a physical 3DS console and imported into Citra. See Dumping Extra Data from a 3DS Console for instructions.
other folders
If a real SD card is compared to Citra’s emulated SD card, Citra may appear to be missing one or more folders present on the real SD card: dbs, backups, and Nintendo DSiWare. The dbs folder contains a 3DS console’s title database. The backups folder contains saved data backed up via the Home Menu. The Nintendo DSiWare folder contains exported DSi exports. Citra does not need any of these folders so there is currently no value in dumping them.
sysdata
This directory can contain two files.
shared_font.bin: this was a legacy system font data dumped from old versions of 3dsutils and is no longer supported. If the user does not have shared font installed, Citra will use the open source font replacement instead. Users should redump their shared font since the open source font replacement may not always look accurate. See Dumping System Archives and the Shared Fonts from a 3DS Console for more information.aes_keys.txt: this file holds decryption keys. See AES Keys for more informationseeddb.bin: SeedDB used for seed crypto & FS SeedDB functions
Citra Home Folder Dump Truck
Tally file extension. The below wiki article is based on user submitted content.
Please verify all hyperlinks and terminal commands below!
Citra is an open-source Nintendo 3DS emulator/debugger written in C++.
Citra Home Folder Dumping
Citra’s features include better visual output, debugging homebrew, and controller support.
The Citra repositories are hosted on GitHub.Citra is licensed under GPLv2 (or any later version). Refer to the license.txt file included.
Usage
You may download a precompiled binary from our website, or you can build it yourself from the source code.
- Build Instructions for Linux
- To Ubuntu users: only 18.04 and up provides sufficient dependencies to build Citra. Please upgrade your system if you are on a lower version (or grab dependencies somewhere else if you know how to)
If you are having trouble building Citra from the source code, see this wiki page:
Now, you’ll need to dump the games you want to play with your 3DS.
If you have any save files or extra data on your 3DS that you want to import into Citra, you’ll have to dump them as well.
If you have updates or DLCs on your 3DS that you want to use with Citra, you’ll have to dump them as well.
In order to make some games work, you’ll have to dump some system files from your 3DS.
You can find a reference for Citra’s default keyboard bindings here:
If you have any questions about Citra, first check these pages:
- User Directory - Explanation of Citra’s file structure
- Citra Web Service - What are and how to use web services tokens
- Compatibility List - List(s) of titles known to be compatible or incompatible with Citra
- Frequently Asked Questions - Help with common questions about using Citra
- Common Issues - Help with issues encountered while building Citra from source
If you don’t see your question answered there, feel free to ask at these places:
- Citra’s Discord at #citra-support
- The #citra IRC Channel on freenode (chat.freenode.net:6667 / SSL: 6697)
- The #citra-dev IRC Channel on freenode (chat.freenode.net:6667 / SSL: 6697)
Development
If you are interested in contributing to Citra’s code, the first thing you should read is this guide, which will show you what style to code in:
You can find info about the 3DS on these pages:
When you are ready, this page will show you how to use Git to setup your own repository:
Using log filters, you can configure Citra to make development easier.
You can find various Homebrew that test the accuracy of Citra here:
Now that everything is setup, you can take a look at these places to see what needs to be done:
- The #citra IRC Channel on freenode (chat.freenode.net:6667 / SSL: 6697)
- The #citra-dev IRC Channel on freenode (chat.freenode.net:6667 / SSL: 6697)