mirrors/shadPS4
1
0
Fork 0
mirror of https://github.com/shadps4-emu/shadPS4.git synced 2025-12-16 16:48:57 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update quick start with instructions tailored to the QtLauncher.

Stephen Miller
2025-12-06 11:35:17 -06:00
parent da42139e49
commit 8eb5529467
1 changed files with 13 additions and 18 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
I.-Quick-start-[Users].md

@@ -1,6 +1,6 @@
# Quick start
#### This guide gives you the basics for installing the emulator in the best possible conditions, including all the pre-requisites for launching a game.
<b>This guide gives you the basics for installing the emulator in the best possible conditions, including all the pre-requisites for launching a game.</b>
> [!WARNING]
> shadPS4 is still early in development. Many games do not work, and the few that do work usually face various emulation issues.
@@ -51,21 +51,17 @@ Before proceeding, ensure your drivers are up to date:
## 2. Installation
### 2.1 Download shadPS4
### 2.1 Download shadPS4QtLauncher
> [!TIP]
> For a quick start, we will use the **Qt** version. The Qt version of shadPS4 comes with a GUI that makes it easier to use and configure.
<br /> There are also SDL builds, which run through the command line. These builds are less user-friendly, so using Qt builds is recommended for newer users.
> This guide is written around the shadPS4 QtLauncher, which provides a GUI for using shadPS4 and can be downloaded here https://github.com/shadps4-emu/shadps4-qtlauncher/releases
<br /> The releases at https://github.com/shadps4-emu/shadPS4/releases work as a command-line tool, which more experienced users may prefer.
1. Follow this link: **https://github.com/shadps4-emu/shadPS4/releases**
2. You can decide between two release version:
- `Pre-release-xxx` (These are unstable builds with the most recent development changes)
- `Release` (Latest stable release, eg 0.10.0)
3. Click on `⏵ Assets`, and find a file with your OS (`win64`, `linux`, `macos`) and the word `Qt` in the name.
- For example, if you want the latest version for Windows, click on `shadps4-win64-qt-xxxx-xx-xx-xxxxxxx.zip`.
4. Extract the downloaded archive to your preferred location.
1. Follow this link: **https://github.com/shadps4-emu/shadps4-qtlauncher/releases**
2. There you will see one release. In there, click on `⏵ Assets`, and find a file with your OS (`win64`, `linux`, `macos`) in the name.
3. Extract the downloaded archive to your preferred location.
> [!WARNING]
> Do not extract shadPS4, or set any of it's user-selected directories into a folder that requires privileges to access!
> Do not extract shadPS4, or set any of it's user-selected directories into a folder that requires extra privileges to access!
<br /> This can cause various weird emulation issues, or prevent shadPS4 from running entirely.
---
@@ -73,19 +69,19 @@ Before proceeding, ensure your drivers are up to date:
**For Windows:**
1. First, you will need **Microsoft Visual C++ 2022** to run it.
- Download it from here: **https://aka.ms/vs/17/release/vc_redist.x64.exe** and install it before next step
2. Open the extracted folder and run shadPS4.exe.
2. Open the extracted folder and run shadPS4QtLauncher.exe.
**For Linux:**
1. Open the extracted folder.
2. Start `Shadps4-qt.AppImage`.
2. Start `shadPS4QtLauncher-qt.AppImage`.
**For macOS:**
1. Open the extracted folder.
2. A window should pop up with the text `shadps4 Not Opened`, tap on `Done`.
2. A window should pop up with the text `shadPS4QtLauncher Not Opened`, tap on `Done`.
3. Navigate to the Apple icon on the top left of your screen and tap on it. In the newly appeared menu there is an option called `System Settings`, tap on it.
4. After the `System Settings` application has been opened, navigate to the `Privacy & Security` tab and scroll down in the new opened tab till you see the message `shadps4 was blocked to protect your Mac`
4. After the `System Settings` application has been opened, navigate to the `Privacy & Security` tab and scroll down in the new opened tab till you see the message `shadPS4QtLauncher was blocked to protect your Mac`
5. On the right side of the message, there is a button called `Open Anyway`, tap on it.
6. A new window should pop up which says `Open shadps4? `, tap on the `Open Anyway` button and enter your password or use your fingerprint to confirm.
6. A new window should pop up which says `Open shadPS4QtLauncher? `, tap on the `Open Anyway` button and enter your password or use your fingerprint to confirm.
---
## 3. Install games and related content
@@ -115,7 +111,6 @@ Installing DLC is slightly different:
4. Once finished, your installed DLC should appear ingame.
---
## 4. Dumping firmware modules
shadPS4 can load some modules in:
* `LLE mode`: Low Level Emulation: Using the firmware files of the console directly;