QT Multimedia is mandatory for building on Windows, and it's not mentioned in the guide.
5.6 KiB
Build shadPS4 for Windows
This tutorial reads as if you have none of the prerequisites already installed. If you do, just ignore the steps regarding installation.
If you are building to contribute to the project, please omit --depth 1
from the git invocations.
Note: ARM64 is not supported! As of writing, it will not build nor run. The instructions with respect to ARM64 are for developers only.
Option 1: Visual Studio 2022
(Prerequisite) Download the Community edition from Visual Studio 2022
Once you are within the installer:
- Select
Desktop development with C++
- Go to "Individual Components" tab
- Search and select
C++ Clang Compiler for Windows
andMSBuild support for LLVM
- Continue the installation
(Prerequisite) Download Qt
Beware, this requires you to create a Qt account. If you do not want to do this, please follow the MSYS2/MinGW compilation method instead.
-
Under the current, non beta version of Qt (at the time of writing 6.7.3), select the option
MSVC 2022 64-bit
or similar, as well asQT Multimedia
.
If you are on Windows on ARM / Qualcomm Snapdragon Elite X, selectMSVC 2022 ARM64
instead.Go through the installation normally. If you know what you are doing, you may unselect individual components that eat up too much disk space.
-
Download and install Qt Visual Studio Tools
Once you are finished, you will have to configure Qt within Visual Studio:
- Tools -> Options -> Qt -> Versions
- Add a new Qt version and navigate it to the correct folder. Should look like so:
C:\Qt\6.7.3\msvc2022_64
- Enable the default checkmark on the new version you just created.
(Prerequisite) Download Git for Windows
Go through the Git for Windows installation as normal
Cloning the source code
- Open Git for Windows, navigate to a place where you want to store the shadPS4 source code folder
- Clone the repository by running
git clone --depth 1 --recursive https://github.com/shadps4-emu/shadPS4
Compiling with Visual Studio GUI
- Open up Visual Studio, select
Open a local folder
and select the folder with the shadPS4 source code. The folder should containCMakeLists.txt
- Change x64-Clang-Debug to x64-Clang-Release if you want a regular, non-debug build.
- If you want to build shadPS4 with the Qt Gui:
- Click x64-Clang-Release and select "Manage Configurations"
- Look for "CMake command arguments" and add to the text field
-DENABLE_QT_GUI=ON -DCMAKE_PREFIX_PATH=C:\Qt\6.7.3\msvc2022_64
(Change Qt path if you've installed it to non-default path) - Press CTRL+S to save and wait a moment for CMake generation
- Change the project to build to shadps4.exe
- Build -> Build All
Your shadps4.exe will be in C:\path\to\source\Build\x64-Clang-Release\
To automatically populate the necessary files to run shadPS4.exe, run in a command prompt or terminal:
C:\Qt\6.7.3\msvc2022_64\bin\windeployqt.exe "C:\path\to\shadps4.exe"
(Change Qt path if you've installed it to non-default path)
Option 2: MSYS2/MinGW
(Prerequisite) Download MSYS2
Go through the MSYS2 installation as normal
If you are building to distribute, please omit -DCMAKE_CXX_FLAGS="-O2 -march=native"
within the build configuration step.
Normal x86-based computers, follow:
- Open "MSYS2 MINGW64" from your new applications
- Run
pacman -Syu
, let it complete; - Run
pacman -S --needed git mingw-w64-x86_64-binutils mingw-w64-x86_64-clang mingw-w64-x86_64-cmake mingw-w64-x86_64-rapidjson mingw-w64-x86_64-ninja mingw-w64-x86_64-ffmpeg
- Optional (Qt only): run
pacman -S --needed mingw-w64-x86_64-qt6-base mingw-w64-x86_64-qt6-tools mingw-w64-x86_64-qt6-multimedia
- Optional (Qt only): run
- Run
git clone --depth 1 --recursive https://github.com/shadps4-emu/shadPS4
- Run
cd shadPS4
- Run
cmake -S . -B build -DCMAKE_C_COMPILER="clang.exe" -DCMAKE_CXX_COMPILER="clang++.exe" -DCMAKE_CXX_FLAGS="-O2 -march=native"
- Optional (Qt only): add
-DENABLE_QT_GUI=ON
- Optional (Qt only): add
- Run
cmake --build build
- Optional (Qt only): run
windeployqt6 build/shadps4.exe
- Optional (Qt only): run
- To run the finished product, run
./build/shadPS4.exe
ARM64-based computers, follow:
- Open "MSYS2 CLANGARM64" from your new applications
- Run
pacman -Syu
, let it complete; - Run
pacman -S --needed git mingw-w64-clang-aarch64-binutils mingw-w64-clang-aarch64-clang mingw-w64-clang-aarch64-rapidjson mingw-w64-clang-aarch64-cmake mingw-w64-clang-aarch64-ninja mingw-w64-clang-aarch64-ffmpeg
- Optional (Qt only): run
pacman -S --needed mingw-w64-clang-aarch64-qt6-base mingw-w64-clang-aarch64-qt6-tools mingw-w64-clang-aarch64-qt6-multimedia
- Optional (Qt only): run
- Run
git clone --depth 1 --recursive https://github.com/shadps4-emu/shadPS4
- Run
cd shadPS4
- Run
cmake -S . -B build -DCMAKE_C_COMPILER="clang.exe" -DCMAKE_CXX_COMPILER="clang++.exe" -DCMAKE_CXX_FLAGS="-O2 -march=native"
- Optional (Qt only): add
-DENABLE_QT_GUI=ON
- Optional (Qt only): add
- Run
cmake --build build
- Optional (Qt only): run
windeployqt6 build/shadps4.exe
- Optional (Qt only): run
- To run the finished product, run
./build/shadPS4.exe
Note on MSYS2 builds
These builds may not be easily copyable to people who do not also have a MSYS2 installation. If you want to distribute these builds, you need to copy over the correct DLLs into a distribution folder. In order to run them, you must be within the MSYS2 shell environment.