Building for Linux
Clone this wiki locally
An unofficial PKGBUILD of Citra is available for Arch Linux on the AUR.
You'll need to download and install the following to build Citra:
apt-get install sdl2or
apt-get install libsdl2-2.0-0or
apt-get install libsdl2-dev
pacman -S sdl2
apt-get install qtbase5-dev libqt5opengl5-dev
pacman -S qt5
- GCC v5+ (for C++14 support)
apt-get install build-essential
pacman -S base-devel
apt-get install cmake
pacman -S cmake
Clang 3.8 (optional build alternative)
apt-get install clang libc++-dev(in some distros, clang-3.8).
pacman -S clang libc++
Cloning Citra in Git:
git clone --recursive https://github.com/citra-emu/citra cd citra
--recursive option automatically clones the required Git submodules too.
mkdir build && cd build cmake .. make sudo make install (currently doesn't work, needs to be fixed)
Optionally, you can use "cmake -i .." to adjust various options (e.g. disable the Qt GUI).
Note: It is important you use libc++ vs. , otherwise your build will likely fail. libc++ is not 100% complete on GNU/Linux, but works well for this build. The libstdc++ std::string is a different data structure than the libc++ std::string. See: LLVLM.org. If libc++ is not used, some warnings are treated as errors. Using clang is only really recommended for users not using GCC >= 5. Also see Clang Comparison.
mkdir build && cd build cmake -DCMAKE_CXX_COMPILER=clang++-3.8 \ -DCMAKE_C_COMPILER=clang-3.8 \ -DCMAKE_CXX_FLAGS="-O2 -g -stdlib=libc++" .. make sudo make install (currently doesn't work, needs to be fixed)
Building Citra (Optimized):
mkdir build && cd build cmake .. -DCMAKE_BUILD_TYPE=Release make sudo make install (currently doesn't work, needs to be fixed)
Building with debug symbols:
cmake .. -DCMAKE_BUILD_TYPE=RelWithDebInfo make
Running without installing:
After building, the binaries
citra-qt (depending on your build options) will end up in
# SDL cd build/src/citra/ ./citra # Qt cd build/src/citra_qt/ ./citra-qt
cd data gdb ../build/src/citra_qt/citra-qt (gdb) run <crash> (gdb) bt