On Windows, all library dependencies are automatically included within the externals
folder, or can be downloaded on-demand. To build yuzu, you need to install:
from Codeberg repo (the --recursive
option automatically clones the required Git submodules):
git clone --depth 1 --recursive https://codeberg.org/litucks/torzu.git
cd torzu
from Torzu repo (assuming Tor is installed as a service):
git -c http.proxy=socks5h://127.0.0.1:9050 clone --depth 1 http://vub63vv26q6v27xzv2dtcd25xumubshogm67yrpaz2rculqxs7jlfqad.onion/torzu-emu/torzu.git
cd torzu
git submodule update --init --recursive
C:\Users\<user-name>\yuzu
(Master) or C:\Users\<user-name>\yuzu-mainline
(Mainline)torzu
directory./build
subdirectory inside the source directory or some other directory of your choice. (Tell CMake to create it.)Visual Studio 17 2022
, with x64
for the optional platform.(Note: If you used GitHub's own app to clone, run git submodule update --init --recursive
to get the remaining dependencies)
If you get an error about missing packages, enable YUZU_USE_BUNDLED_VCPKG
, and then click Configure again.
YUZU_TESTS
in this case since Catch2 is not yet supported with this.)yuzu.sln
in Visual Studio 2022, which is located in the build folder.yuzu
has the graphical user interface, while yuzu-cmd
doesn't), select yuzu
or yuzu-cmd
in the Solution Explorer, right-click and Set as StartUp Project
.pacman -Syu
as many times as needed.MSYS2 MinGW 64-bit
(mingw64.exe) shellpacman -Syu git make mingw-w64-x86_64-SDL2 mingw-w64-x86_64-cmake mingw-w64-x86_64-qt5 mingw-w64-x86_64-toolchain
export PATH="<Absolute path to the Bin folder in Vulkan SDK>:$PATH"
export VCPKG_DEFAULT_HOST_TRIPLET=x64-mingw-static
export VCPKG_DEFAULT_TRIPLET=x64-mingw-static
We have to manually set some VCPKG variables for some reason. This issue probably already exists in the original Yuzu.
from NotABug repo (the --recursive
option automatically clones the required Git submodules):
git clone --depth 1 --recursive https://notabug.org/litucks/torzu.git
cd torzu
git submodule update --init --recursive
from Torzu repo (assuming Tor is installed as a service):
git -c http.proxy=socks5h://127.0.0.1:9050 clone --depth 1 http://vub63vv26q6v27xzv2dtcd25xumubshogm67yrpaz2rculqxs7jlfqad.onion/torzu-emu/torzu.git
cd torzu
git submodule update --init --recursive
mkdir build && cd build
cmake -G "MSYS Makefiles" -DYUZU_USE_BUNDLED_VCPKG=ON -DYUZU_TESTS=OFF -DVCPKG_TARGET_TRIPLET=x64-mingw-static ..
DVCPKG_TARGET_TRIPLET
has to be overriden to x64-mingw-static
here to generate a static build that doesn't require extra DLLs to be packaged.
make -j$(nproc) yuzu
The reason we are not using make all
is that linker will fail.
This is because Yuzu developer didn't set linker flags properly in their CMakeLists.txt
for some reason. So we have add something manually.
VERBOSE=1 make yuzu
This will shows the exact link command, should be something like:
cd ***/src/yuzu && /mingw64/bin/c++.exe -O3 -DNDEBUG -Wl,--subsystem,windows -Wl,--whole-archive ...
Copy the command line and add the following arguments:
-static-libstdc++ -lws2_32 -s -Wl,--Map,../../bin/yuzu.map
Explanation of the extra arguments:
-static-libstdc++
: Force usage of static libstdc++, without this argument the binary will have no entrypoint.-lws2_32
: Link the ws2_32.a provided by mingw.-s
: Optional, strip the symbols from the output binary.-Wl,--Map,../../bin/yuzu.map
: Optional, output a separated linker map to ../../bin/yuzu.map
Please note that -lw2_32
is already added, but the order is not correct and hence cause linking fails.Now the built executable should work properly. Repeating step 4 should build yuzu-cmd
as well.
Some DLLs (e.g., Qt) are still required as they cannot being linked statically. Copying those DLLs from the latest release is one option.
Doesn't require the rather large Qt dependency, but you will lack a GUI frontend:
-DENABLE_QT=NO
flag to cmakeTo build yuzu, you need to install the following:
Build type: Release
Name: Release
Toolchain Visual Studio
Generator: Let CMake decide
Build directory: build
from Codeberg repo (the --recursive
option automatically clones the required Git submodules):
git clone --depth 1 --recursive https://codeberg.org/litucks/torzu.git
cd torzu
from Torzu repo (assuming Tor is installed as a service):
git -c http.proxy=socks5h://127.0.0.1:9050 clone --depth 1 http://vub63vv26q6v27xzv2dtcd25xumubshogm67yrpaz2rculqxs7jlfqad.onion/torzu-emu/torzu.git
cd torzu
git submodule update --init --recursive
followed by:
mkdir build
cd build
cmake .. -G "Visual Studio 17 2022" -A x64
cmake --build . --config Release