Diagnostics

Problem → likely cause → fix.

First step for almost any issue: Settings → System → Restore default settings. Also check per-game settings. PPSSPP saves overrides per title.

ProblemLikely causeFix
PPSSPP crashes on startup Bad graphics driver or audio backend Update drivers; on Windows switch Audio backend from WASAPI to DirectSound in ppsspp.ini; try OpenGL/D3D11 backend
Crash mid-game after enabling hacks Fast Memory, frameskip, or speedhacks Reset to defaults. If disabling Fast Memory fixes it, report on GitHub. That is a bug.
Severe lag / low FPS Resolution or backend too heavy Drop to 1×–2× PSP, disable texture scaling & shaders, try Vulkan ↔ OpenGL
Missing textures or effects Speedhacks or block transfer off Enable Simulate block transfer; turn off Skip buffer effects; use Buffered rendering mode
Crackling or no audio Buffer too small Increase Audio latency one step at a time; disable Audio stretching
Save failed / Load failed Wrong memstick path or no write permission Move saves out of OneDrive/cloud folders; set memstick to a local path; on Android re-pick the PSP folder
Games missing after Android 13 update SD card scoped-storage issues Re-browse to game folder in PPSSPP; some users fixed by reformatting SD and copying files back (r/PPSSPP reports)
Vulkan black screen Driver lacks full Vulkan support Switch to OpenGL (Android) or D3D11 (Windows); update GPU drivers
Multiplayer won't connect Firewall or mismatched ad-hoc settings Same PPSSPP version on all devices; matching ad-hoc server address; disable Fast Memory if needed for some titles

Universal reset procedure

  1. 1. Settings → System → Restore default settings.

    2. Quit PPSSPP fully and relaunch.

    3. Set backend only (Vulkan or OpenGL). Test one game.

    4. Raise rendering resolution one step if FPS is stable.

    5. If still broken, try a git build from the download page or ask on community forums.

Editing ppsspp.ini manually

When the UI will not load, edit the config file directly. Open memstick folder from a working session or find it at Documents/PPSSPP/memstick/PSP/SYSTEM/ppsspp.ini on Windows.

GraphicsBackend values

0 OpenGL · 2 Direct3D 11 · 3 Vulkan (may vary by version)

AudioBackend

Switch WASAPI ↔ DirectSound on Windows if startup crashes before the menu appears.