Common Issues

Building for all platforms

  • If you have encountered such an error: /path/to/citra/externals/ does not contain a CMakeLists.txt file., while configuring in CMake, it means you forgot to add --recursive when git clone. You can fix it by the following commands to obtain all submodules:

       git submodule init
       git submodule update --recursive

Building for Windows

  • For running Citra builds, make sure to have Qt5Core.dll, Qt5Gui.dll, Qt5OpenGL.dll, Qt5Widgets.dll, Qt5Multimedia.dll, Qt5Network.dll and SDL2.dll in either the application directory or in the system PATH. If not there those files are in C:\Qt\5.4\msvc2013_64_opengl\bin,copy them here. Else, Citra will fail on startup. 7

  • Also, make sure platforms/qwindows.dll in the application directory. If not there you will find it in C:\Qt\5.4\msvc2013_64_opengl\plugins\platforms by default. Just copy it.


  • You will also need the x64 variant of Visual C++ Redistributable for Visual Studio 2015 from Microsoft (vc_redist.x64.exe), if you don’t already have it.

  • QT 5.3 is known to fail in Windows building citra. Install QT 5.3.1 or greater for the result.

  • If CMake keeps making Win32 builds, you may need to manually specify CMAKE_GENERATOR_PLATFORM with a string value of x64 when configuring.