# PPSSPP - General Guide
A PSP emulator that can also upscale textures to make them sharper and you can enable post-processing shaders to adjust color and brightness the way you like and other effects.
---
### PPSSPP Links
| Resource | Link |
|----------|------|
| PPSSPP - Blog | [Link](https://www.ppsspp.org/blog/) |
| PPSSPP - Docs | [Link](https://www.ppsspp.org/docs/) |
| PPSSPP - FAQ | [Link](https://www.ppsspp.org/docs/faq/) |
| PPSSPP - Game Compatibility | [Link](https://report.ppsspp.org/games) |
| PPSSPP - Getting Started Guide | [Link](https://www.ppsspp.org/docs/getting-started/) |
| PPSSPP - Github | [Link](https://github.com/hrydgard/ppsspp) |
| PPSSPP - Webpage | [Link](https://www.ppsspp.org/) |
---
## Where to put the games?
PSP games should be put under the `retrodeck/roms/psp/` directory.
---
## What file formats are supported?
| File Format | Description |
|-------------|-------------|
| .elf | Executable and Linkable Format |
| .cso | Compressed ISO image file |
| .iso | Standard ISO disc image |
| .pbp | PlayStation Portable Update file |
| .prx | PlayStation Portable executable file |
| .chd | Compressed Hunks of Data **(Recommended)**|
---
## Does PPSSPP require BIOS, Game Data or Firmware files?
No
---
## Directory structure
| Type | Directory | Comment |
|:-------------:|:------------------------------------------------------------------|:---------------------------------------|
| Cheats | `retrodeck/cheats/PPSSPP/` | PSP/Cheats |
| Config | `.var/app/net.retrodeck.retrodeck/config/PPSSPP-SA/PSP/` | |
| DLC / Game | `retrodeck/storage/PPSSPP/GAME/` | PSP/GAME |
| Logs | `retrodeck/logs/PPSSPP/` | PSP/SYSTEM/DUMP |
| Mods | `retrodeck/mods/PPSSPP/PLUGINS/` | PSP/PLUGINS |
| ROMs | `retrodeck/roms/psp/` | |
| Saves | `retrodeck/saves/PSP/PPSSPP-SA/` | |
| Shaders | `retrodeck/shaders/PPSSPP/` | PSP/shaders |
| States | `retrodeck/states/PSP/PPSSPP-SA/` | |
| Texture Packs | `retrodeck/texture_packs/PPSSPP/TEXTURES/` | PSP/TEXTURES |
---
## Finding GameIDs
`GameID` is different for every game. It's a unique code for each released game per region.
**GameID:** `ULUS-10080` corresponds to the NTSC-U release of `007-From Russia with Love`.
You can search various databases or wikis online to find the correct GameID for the version of the game you have for example:
- [psxdatacenter.com](https://psxdatacenter.com/).
- Wikipedia
---
## Adding Texture Packs
The `retrodeck/texture_packs/ppsspp-sa/` folder represents the `/PSP/TEXTURES/` folder in PPSSPP.
**Note:** Some texture packs may be made for a specific version or region of the game.
### Enable Custom Textures
1. Open PPSSPP inside **RetroDECK Configurator** by pressing `Open Emulator` → `PPSSPP`.
2. Go to `Settings` → `Tools` → `Developer Tools` → `Replace Textures` and set it to `On`.
### How to Add Texture Packs
1. Extract the texture pack files from compressed `.zip` or other formats into folders.
2. Navigate to `retrodeck/texture_packs/PPSSPP/TEXTURES/`. The folders are named by `GameID`.
3. Paste the textures into the correct folder: `retrodeck/texture_packs/PPSSPP/TEXTURES/`
4. If the textures match the game, they should load the next time you launch it.
---
## Adding DLCs
The `retrodeck/storage/PPSSPP/GAME` folder represents the `PSP/GAME/` folder in PPSSPP.
**Note:** Some DLC may be made for a specific version or region of the game.
### How-to: Add DLC
1. Extract the dlc from compressed `.zip` or other formats into folders.
2. Navigate to `retrodeck/storage/PPSSPP/GAME/`. The folders are named by `GameID`.
3. Paste the DLC into the correct folder: `retrodeck/storage/PPSSPP/GAME/`
4. If the DLC match the game, they should load the next time you launch it.
---
## Troubleshooting
| Topic | Issue | Solution |
|---|---|---|
| **UI overscales on Fullscreen** | UI overscales on Wayland when OS scaling >100% on Vulkan. | Open PPSSPP via **RetroDECK Configurator**.
Go to **Settings → Backend** → switch from **Vulkan** to **OpenGL**. |
| **Steam Deck OLED Flickering** | Some games may flicker on the Steam Deck OLED. | Lower the display refresh rate from **90Hz** to **60Hz**. |
---