DuckStation - PlayStation (PSX) Emulator

Features

CPU Recompiler/JIT (x86_64 work-in-progress, AArch64 planned)
Hardware (D3D11 and OpenGL) and software rendering
Upscaling and true colour (24-bit) in hardware renderers
"Fast boot" for skipping BIOS splash/intro
Save state support
Windows and Linux support - macOS may work, but not supported by author

Building

Clone the respository with submodules (git clone --recursive or git clone and git submodule update --init).

Windows

Requirements:

Visual Studio 2019

Open the Visual Studio solution duckstation.sln in the root, or "Open Folder" for cmake build.
Build, binaries are located in bin/x64.
Copy the DLL files from dep/msvc/bin64 to the binary directory.
Run duckstation-x64-Release.exe or whichever config you used.

Linux

Requirements:

CMake
SDL2

Create a build directory, either in-tree or elsewhere.
Run cmake to configure the build system. Assuming a build subdirectory of build-release, cd build-release && cmake -DCMAKE_BUILD_TYPE=Release -GNinja ...
Compile the source code. For the example above, run ninja.
Run the binary, located in the build directory under src/duckstation/duckstation.

Running

Configure the BIOS path in the settings.
Open a disc image file, enjoy.

Default keyboard bindings

Keyboard bindings are currently not customizable. For reference:

D-Pad: W/A/S/D or Up/Left/Down/Right
Triangle/Square/Circle/Cross: I/J/L/K or Numpad8/Numpad4/Numpad6/Numpad2
L1/R1: Q/E
L2/L2: 1/3
Start: Enter
Select: Backspace

Gamepads are automatically detected and supported. Tested with an Xbox One controller. To access the menus with the controller, press the right stick down and use the D-Pad to navigate, A to select.

Useful hotkeys

F1-F8: Quick load/save (hold shift to save)
F11: Toggle fullscreen
Tab: Temporarily disable speed limiter
Pause/Break: Pause/resume emulation
Space: Frame step
End: Toggle software renderering
Page Up/Down: Increase/decrease resolution scale in hardware renderers

Tests

Passes amidog's CPU and GTE tests, partial passing of CPX tests

Screenshots

Disclaimers

Icon by icons8: https://icons8.com/icon/74847/platforms.undefined.short-title

"PlayStation" and "PSX" are registered trademarks of Sony Interactive Entertainment Europe Limited. This project is not affiliated in any way with Sony Interactive Entertainment.

2.8 KiB Raw Blame History