Building for Windows

MSVC Build for Windows

Minimal Dependencies

On Windows, all library dependencies are automatically included within the “externals” folder or can be downloaded on-demand. To build Citra, you simply need to install:

  • Visual Studio 2022 - Make sure to select C++ support in the installer.

  • CMake - Used to generate Visual Studio project files. 2

  • Vulkan SDK - Make sure to select Latest SDK.

  • Git - We recommend Git for Windows. 3

  • While installing Git Bash, you should tell it to include Git in your system path. (Choose the “Git from the command line and also from 3rd-party software” option.) If you missed that, don’t worry, you’ll just have to manually tell CMake where your git.exe is, since it’s used to include version info into the built executable.

4

Cloning Citra in Git:

Master:

git clone --recursive https://github.com/citra-emu/citra.git
cd citra

Canary:

git clone --recursive https://github.com/citra-emu/citra-canary.git
cd citra-canary

9

(Note: Citra by default downloads to C:\Users\\citra (Master) or C:\Users\\citra-canary (Canary)

Building

  • Open the CMake GUI application and point it to the citra (Master) or citra-canary (Canary) directory.

10

  • For the build directory, use a build/ subdirectory inside the source directory or some other directory of your choice. (Tell CMake to create it.)

11

  • Click the “Configure” button and choose Visual Studio 17 2022, with x64 for the optional platform.

12

* NOTE: If you get errors like "XXX does not contain a CMakeLists.txt file" at this step, it means you didn't use the `--recursive` flag in the clone step, or you used tools other than the git CLI. Please run "git submodule update --init --recursive" to get remaining dependencies.
  • Click “Generate” to create the project files.

14

  • Open the solution file citra.sln in Visual Studio 2022, which is located in the build folder.

15

  • Depending on which frontend (SDL2 or Qt) you want to build or run, select “citra” or “citra-qt” in the Solution Explorer, right-click and “Set as Startup Project”.

16 17

  • Select the appropriate build type, Debug for debug purposes or Release for performance (in case of doubt choose the latter).

18

  • Press F5 or select Build → Rebuild Solution in the menu.

19

  • NOTE: Please refer to Common Issues if any errors. If you did not find a solution feel free to ask us in the IRC channel: #citra @ Freenode.

MinGW-w64 Build with MSYS2

Prerequisites to install

Make sure to follow the instructions and update to the latest version by running pacman -Syu as many times as needed.

Install Citra dependencies for MinGW-w64

  • Open the “MSYS2 MinGW 64-bit” (mingw64.exe) shell
  • Download and install all dependencies using: pacman -S mingw-w64-x86_64-{gcc,SDL2,qt6,cmake} make git

Clone the Citra repository with git.

  • git clone --recursive https://github.com/citra-emu/citra.git
  • cd citra

Run the following commands to build Citra (dynamic linked build)

mkdir build && cd build
cmake -G "MSYS Makefiles" -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_FLAGS="-DMICROPROFILE_ENABLED=0" ..
make -j4
# test Citra out with
./bin/citra-qt.exe
Note! This build is not a static build meaning that you need to include all of the dlls with the exe in order to use it.

Creating a static build (Optional)

  • Instead of installing mingw-w64-x86_64-qt6 install mingw-w64-x86_64-qt6-static
  • Add -DMINGW_STATIC_BUILD=1 to the cmake command line

Building without Qt (Optional)

Doesn’t require the rather large Qt dependency, but you will lack a GUI frontend.

  • Pass the -DENABLE_QT=no flag to cmake