mirrors/shadPS4
1
0
Fork 0
mirror of https://github.com/shadps4-emu/shadPS4.git synced 2025-12-18 01:28:36 +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 # 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] > [!WARNING]
> shadPS4 is still early in development. Many games do not work, and the few that do work usually face various emulation issues. > 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. Installation
### 2.1 Download shadPS4 ### 2.1 Download shadPS4QtLauncher
> [!TIP] > [!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. > 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 /> 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. <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** 1. Follow this link: **https://github.com/shadps4-emu/shadps4-qtlauncher/releases**
2. You can decide between two release version: 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.
- `Pre-release-xxx` (These are unstable builds with the most recent development changes) 3. Extract the downloaded archive to your preferred location.
- `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.
> [!WARNING] > [!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. <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:** **For Windows:**
1. First, you will need **Microsoft Visual C++ 2022** to run it. 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 - 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:** **For Linux:**
1. Open the extracted folder. 1. Open the extracted folder.
2. Start `Shadps4-qt.AppImage`. 2. Start `shadPS4QtLauncher-qt.AppImage`.
**For macOS:** **For macOS:**
1. Open the extracted folder. 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. 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. 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 ## 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. Once finished, your installed DLC should appear ingame.
--- ---
## 4. Dumping firmware modules ## 4. Dumping firmware modules
shadPS4 can load some modules in: shadPS4 can load some modules in:
* `LLE mode`: Low Level Emulation: Using the firmware files of the console directly; * `LLE mode`: Low Level Emulation: Using the firmware files of the console directly;