How to create a frame dump

Frame dumps are very useful for graphics debugging. They consist of a complete log of all the graphics used in a frame, which can be loaded back into PPSSPP by another user and debugged.

Tip: if you're not seeing anything at all with certain settings or a backend, create the frame dump while you can see those things. This way you will create a correct frame dump that can be used to troubleshoot the settings.

In PPSSPP 1.7.0 and higher, it's possible to create frame dumps on all platforms, including Android.

Here's how you do it:

1. In PPSSPP's settings, select Tools -> Developer Tools and enable "Allow remote debugger".
2. Start your game, play to the place where you have a graphical problem.
3. Visit this page: http://ppsspp-debugger.unknownbrackets.org/gpu (in PPSSPP 1.8.0 and lower, you may need to use Firebox\Edge.)
4. Press Record.
5. If you're using Android or iOS, you may need to switch back to PPSSPP for it to finish recording.
6. The frame dump should automatically download.
7. Take this file and upload it or email it or whatever. To attach it to a github issue, just zip it up and drag it into the post.

You can visit the debugger URL from a different device, as long as it's connected to the same network.

---

Here's the alternate method that works only on Windows, but also works on PPSSPP 1.5.x and 1.6.x:

• Start your game, play to the place where you have a graphical problem.

• Open the log console (optional)

• Choose Debug->GE Debugger in the window menu

• Press Record

• You'll see something like the following written in the log console:

    N[G3D]: Debugger\Record.cpp:386 Recording filename: C:\dev\ppsspp\Windows\..\memstick/PSP/SYSTEM/DUMP//ULESxxxxx_yyyy.ppdmp
    N[SYSTEM]: Debugger\Record.cpp:623 Recording finished
  

• Take this file and upload it or email it or whatever.