# Duckstation (Legacy) - General Guide
Duckstation is a Playstation 1 - PSX Emulator.
**Note: Legacy Emulator**
Starting with RetroDECK `0.9.0b`, DuckStation changed its licensing from open source to closed source and is therefore marked as **Legacy**.
The Legacy version will no longer receive updates and is provided **as-is**.
---
### Duckstation Links
| Resource | Link |
|----------|------|
| Duckstation - Game Compatibility | [Link](https://docs.google.com/spreadsheets/d/e/2PACX-1vRE0jjiK_aldpICoy5kVQlpk2f81Vo6P4p9vfg4d7YoTOoDlH4PQHoXjTD2F7SdN8SSBLoEAItaIqQo/pubhtml) |
| Duckstation - Github | [Link](https://github.com/stenzek/duckstation) |
| Duckstation - Webpage | [Link](https://www.duckstation.org/) |
| Duckstation - Wiki | [Link](https://www.duckstation.org/wiki/) |
---
## Where to put the games?
PSX games should be put under the `retrodeck/roms/psx/` directory.
---
## What file formats are supported?
| File Format | Description |
|-------------|-------------|
| .bin + .cue | Binary disc image file with cue sheet |
| .img | Disc image file |
| .iso | Standard ISO disc image |
| .chd | Compressed Hunks of Data **(Recommended)** |
| .mds | Media Descriptor File |
| .pbp | PlayStation Portable Update file |
| .ecm | ECM compressed file |
---
## Does Duckstation require BIOS, Game Data or Firmware files?
Yes, there exists several PSX BIOS from different regions and hardware versions.
You need at least one.
[PSX BIOS Guide on Github](https://github.com/LiquidSevens/psx-models-bios-guide)
Here is a few:
| Region | BIOS File Name | Description |
|--------|----------------|-------------|
| **Japan (NTSC-J)** | `scph1000.bin` | First retail PSX BIOS featuring early hardware behavior. |
| **Japan (NTSC-J)** | `scph5500.bin` | Stable mid-generation Japanese BIOS revision. |
| **Japan (NTSC-J)** | `scph7000.bin` | Later Japanese BIOS, same revision as SCPH-5500. |
| **USA (NTSC-U)** | `scph1001.bin` | Most common and highly compatible North American BIOS. |
| **USA (NTSC-U)** | `scph5501.bin` | Later, more accurate BIOS for NTSC-U systems. |
| **USA (NTSC-U)** | `scph7001.bin` | Updated revision similar to SCPH-5501. |
| **Europe (PAL-E)** | `scph5502.bin` | Standard BIOS used for most PAL titles. |
| **Europe (PAL-E)** | `scph7002.bin` | Later PAL revision with improved compatibility. |
| **PS One (Slim Model)** | `scph101.bin` | BIOS for the compact PS One hardware revision. |
### Where to put the PSX BIOS?
Directly into the folder
`retrodeck/bios/`
---
## Directory structure
| Type | Directory | Comment |
|:-------------:|:--------------------------------------------------|:----------------------------------------------------------|
| BIOS | `retrodeck/bios/` | |
| Config | `~/.var/app/net.retrodeck.retrodeck/config/duckstation/` | `settings.xml`, `gameProfiles` folder, `controllerProfiles` folder |
| Dump Audio | `retrodeck/storage/Duckstation/dump/audio/` | duckstation/dump/audio |
| Dump Textures | `retrodeck/storage/Duckstation/dump/textures/` | duckstation/dump/textures |
| ROMs | `retrodeck/roms/psx/` | |
| Saves | `retrodeck/saves/psx/duckstation/` | |
| Shaders | `retrodeck/shaders/Duckstation/` | duckstation/shaders |
| States | `retrodeck/states/psx/duckstation/` | |
| Screenshots | `retrodeck/screenshots/Duckstation/` | duckstation/screenshots |
| Texture Packs | `retrodeck/texture_packs/Duckstation/textures` | duckstation/textures |
---
## How-to: Add Texture Packs
The `retrodeck/texture_packs/duckstation/textures` directory represents the `/duckstation/textures/` directory in Duckstation.
### Enable Custom Textures
If texture replacements are disabled:
- Open Duckstation inside `RetroDECK Configurator` by selecting `Open Emulator` → `Duckstation`.
- Go to `Settings` → `Advanced` → `Tweaks/Hacks`.
- Set `Enable VRAM Write Texture Replacement` to `On`.
- Set `Preload Texture Replacements` to `On`.
### Texture Folder
**Note:** Texture packs may be designed for a specific game version or region. Make sure the texture pack matches your game.
**Note:** `TITLEID` is unique to each game. Check a reliable online resource to find the correct ID.
1. Extract the texture pack from its `.zip` or other compressed archive.
2. Open `retrodeck/texture_packs/duckstation/textures`.
3. Move the extracted texture folder into the `textures` directory. The folders are often named by `TITLEID`.
4. Rename the folder so that it matches the game's `TITLEID` **exactly** and remove additional suffixes such as `_LQ`, `_MQ`, or `_HQ` folder name if there are any.
The resulting directory should follow this structure:
```
retrodeck/
└── texture_packs/
└── duckstation/
└── textures/
└── TITLEID/
└──
```
---