The below wiki article is based on user submitted content. Please verify all hyperlinks and terminal commands below!
See a mistake? Want to contribute? Edit this article on Github
You’ll need to download and install the following to build yuzu:
pacman -S sdl2
apt-get install sdl2or
apt-get install libsdl2-2.0-0or
apt-get install libsdl2-dev
dnf install SDL2-devel
pacman -S qt5
apt-get install qtbase5-dev libqt5opengl5-dev
dnf install qt5-qtbase qt5-qtbase-devel
emerge dev-qt/qtcore dev-qt/qtopengl
pacman -S base-devel
apt-get install build-essential
dnf install gcc
pacman -S cmake
apt-get install cmake
dnf install cmake
Note: Depending on your distro, the version of CMake you get may not be what’s required to build yuzu. Check with cmake –version. Version 3.6 or greater is required for you to be able to build!
pacman -S clang,
libc++is in the AUR. Use yay to install it.
apt-get install clang libc++-dev(in some distros, clang-3.8).
emerge sys-devel/clang sys-libs/libcxx
git clone --recursive https://github.com/yuzu-emu/yuzu cd yuzu
git clone --recursive https://github.com/yuzu-emu/yuzu-canary cd yuzu-canary
--recursive option automatically clones the required Git submodules too.
mkdir build && cd build cmake ../ make sudo make install
Note: you can use make -jN where N is the number of processors available to accelerate the building
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)
#if _LIBCPP_STD_VER ::value) #else _NOEXCEPT #endif
Additionally, on Ubuntu, do:
sudo apt-get install libc++abi-dev && sudo ln -s /usr/include/libcxxabi/__cxxabi_config.h /usr/include/c++/v1/__cxxabi_config.h
mkdir build && cd build cmake .. -DCMAKE_BUILD_TYPE=Release make sudo make install # (currently doesn't work, needs to be fixed)
cmake .. -DCMAKE_BUILD_TYPE=RelWithDebInfo make
After building, the binaries
yuzu-cmd (depending on your build options) will end up in
# SDL cd build/bin/ ./yuzu-cmd # Qt cd build/bin/ ./yuzu
cd data gdb ../build/bin/yuzu # Start GDB (gdb) run # Run yuzu under GDB (gdb) bt # Print a backtrace of the entire callstack to see which codepath the crash occurred on