shadPS4/documents/Quickstart/Quickstart.md
squidbus 3bc876ca78
Some checks are pending
Build and Release / reuse (push) Waiting to run
Build and Release / clang-format (push) Waiting to run
Build and Release / get-info (push) Waiting to run
Build and Release / windows-sdl (push) Blocked by required conditions
Build and Release / windows-qt (push) Blocked by required conditions
Build and Release / macos-sdl (push) Blocked by required conditions
Build and Release / macos-qt (push) Blocked by required conditions
Build and Release / linux-sdl (push) Blocked by required conditions
Build and Release / linux-qt (push) Blocked by required conditions
Build and Release / linux-sdl-gcc (push) Blocked by required conditions
Build and Release / linux-qt-gcc (push) Blocked by required conditions
Build and Release / pre-release (push) Blocked by required conditions
renderer_vulkan: Improve handling of required vs optional extensions. (#2792)
* renderer_vulkan: Improve handling of required vs optional extensions.

* documents: Update quickstart Vulkan requirements.
2025-04-15 22:31:58 -07:00

2.3 KiB

shadPS4 Quickstart

Summary

Minimum PC requirements

CPU

  • A processor with at least 4 cores and 6 threads
  • Above 2.5 GHz frequency
  • A CPU supporting the following instruction sets: MMX, SSE, SSE2, SSE3, SSSE3, SSE4.1, SSE4.2, AVX, F16C, CLMUL, AES, BMI1, MOVBE, XSAVE, ABM
    • Intel: Haswell generation or newer
    • AMD: Jaguar generation or newer
    • Apple: Rosetta 2 on macOS 15.4 or newer

GPU

  • A graphics card with at least 1GB of VRAM
  • Up-to-date graphics drivers
  • Vulkan 1.3 with the VK_KHR_swapchain and VK_KHR_push_descriptor extensions

RAM

  • 8GB of RAM or more

OS

  • Windows 10 or Ubuntu 22.04

How to run the latest Work-in-Progress builds of shadPS4

  1. Go to https://github.com/shadps4-emu/shadPS4/releases In the release identified as 'pre-release' click on the down arrow(Assets), select your operating system of choice (the "qt" versions have a user interface, which is probably the one you want. The others are SDL versions, which can only be run via command line). image

  2. Once downloaded, extract to its own folder, and run shadPS4's executable from the extracted folder.

  3. Upon first launch, shadPS4 will prompt you to select a folder to store your installed games in. Select "Browse" and then select a folder that contains your dumped games.

Configure the emulator

To configure the emulator, you can go through the interface and go to "settings".

You can also configure the emulator by editing the config.toml file located in the user folder created after the application is started (Mostly useful if you are using the SDL version). Some settings may be related to more technical development and debugging.
For more information on this, see Debugging.