Skip to content

Commit

Permalink
Docs: Update ffmpeg troubleshooting section (#339)
Browse files Browse the repository at this point in the history
  • Loading branch information
kamfretoz authored Jul 22, 2024
1 parent f0c6ff3 commit 1eaf076
Show file tree
Hide file tree
Showing 2 changed files with 27 additions and 15 deletions.
34 changes: 27 additions & 7 deletions docs/troubleshooting/general.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,18 +15,38 @@ If you are encountering issues, before troubleshooting them it is highly recomme

## Game are stuck on black screen or does not load correctly

This usually indicates that your dump is corrupted. To verify the integrity of your dump, right-click on the game you want to check, then click on properties.
:::info
This usually indicates that your dump is corrupted or incomplete.
:::

To verify the integrity of your dump, right-click on the game you want to check on the game list, then click on properties. You should be greeted with the game properties window. Next up click the verify button under the disc track list.

You should be greeted with the game properties window. Next up click the verify button under the disc track list.
<Image src={require("./img/verify.webp").default} />

If it returns a green checkmark (✅) then your game dumps are working just fine, otherwise if it returns a red cross (❌) then your dumps are corrupted and you will have to redump your game. You can checkout [the gathering files page](../setup/dumping.md#dumping-ps2-discs-via-imgburn) for the instructions on how to do so.

<Image src={require("./img/verify.webp").default} />
## Unable to start Video Capture

<Image src={require("./img/ffmpeg.webp").default} />

:::info
PCSX2 requires some additional ffmpeg libraries to enable video capture.
:::

### Windows

- Grab the ffmpeg Windows files [here](https://github.com/PCSX2/pcsx2-windows-dependencies/releases/download/FFMPEG/ffmpeglibs-6.0.7.7z).
- Extract the zip file, then place the extracted dll files in your PCSX2 folder. They should be in the same folder as the main PCSX2 exe file.

### Linux

If you are using a distro which is not based on Ubuntu, it is recommended that you use the Flatpak instead of the AppImage for video recording support.

## Still have problems?

If your game is not working, there are a few things you can do:
If your game is not working or you are still having issues, there are a few things you can do:

- Check the [compatibility page](/compat) to see if the game has been tested to run properly
- Consult the [wiki page](https://wiki.pcsx2.net) for the game for similar information
- Check the [GitHub issues page](https://github.com/PCSX2/pcsx2/issues) to see if there are any reported issues
- Check the [compatibility page](/compat) to see if the game has been tested to run properly.
- Consult the [wiki page](https://wiki.pcsx2.net) for the game for similar information.
- Check the [GitHub issues page](https://github.com/PCSX2/pcsx2/issues) to see if there are any reported issues.
- Join our [Discord server](https://discord.com/invite/TCz3t9k) for futher assistance.
8 changes: 0 additions & 8 deletions docs/troubleshooting/windows.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,14 +18,6 @@ If you see this error message during PCSX2 startup such as the following:
- You need the [Latest Visual C++ 2019 x64 Redistributables](https://aka.ms/vs/17/release/vc_redist.x64.exe) to run PCSX2.
- They are combined with other yearly releases Visual Studio 2015, 2017, 2019, and 2022. 64-bit version (x64) is required for 1.7.0 and higher (though early 1.7 builds still required 32 bit versions)

## Unable to start Video Capture

<Image src={require("./img/ffmpeg.webp").default} />

- PCSX2 requires some additional ffmpeg libraries to enable video capture.
- Grab the ffmpeg Windows files [here](https://github.com/PCSX2/pcsx2-windows-dependencies/releases/download/FFMPEG/ffmpeglibs-6.0.7.7z).
- Extract the zip file, then place the extracted dll files in your PCSX2 folder. They should be in the same folder as the main PCSX2 exe file.

## Crashes

There are various problems that can cause PCSX2 to crash during operation, here we list the most common ones:
Expand Down

0 comments on commit 1eaf076

Please sign in to comment.