Fast PlayStation 1 emulator for x86-64/AArch32/AArch64/RV64
Go to file
Connor McLaughlin da14b10e72 Split MemoryCard and PadDevice (now Controller) 2019-12-09 00:52:00 +10:00
.github/workflows Don't create .7z within .zip for windows build 2019-11-26 20:00:43 +10:00
CMakeModules Import initial work on Android frontend 2019-11-29 00:17:24 +10:00
android Android: Get storage permissions before populating game list 2019-12-04 21:54:37 +10:00
dep dep: Add vixl (AArch32/64 assembler) 2019-12-04 20:32:38 +10:00
src Split MemoryCard and PadDevice (now Controller) 2019-12-09 00:52:00 +10:00
.clang-format Initial commit 2019-09-11 14:00:42 +10:00
.gitattributes Initial commit 2019-09-11 14:00:42 +10:00
.gitignore Initial commit 2019-09-11 14:00:42 +10:00
.gitmodules Initial commit 2019-09-11 14:00:42 +10:00
CMakeLists.txt Import initial work on Android frontend 2019-11-29 00:17:24 +10:00
CMakeSettings.json Initial commit 2019-09-11 14:00:42 +10:00
LICENSE Initial commit 2019-09-11 14:00:42 +10:00
README.md Update README.md with build instructions for Android 2019-12-04 21:57:47 +10:00
duckstation.sln dep: Add tinyxml2 2019-12-01 19:52:00 +10:00

README.md

DuckStation - PlayStation (PSX) Emulator

Main Window Screenshot

Features

  • CPU Recompiler/JIT (x86-64 and AArch64)
  • 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 actively maintained
  • Currently only .bin/.cue disc image formats are supported. Additional formats are planned
  • Direct booting of homebrew executables

System Requirements

  • A CPU faster than a potato.
  • For the hardware renderers, a GPU capable of OpenGL 3.0/OpenGL ES 3.0/Direct3D 11 Feature Level 10.0 and above. So, basically anything made in the last 10 years or so.
  • SDL-compatible game controller (e.g. XB360/XBOne)

Building

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

Windows

Requirements:

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

Linux

Requirements:

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

Android

Requirements:

  • Android Studio with the NDK and CMake installed
  1. Open the project in the android directory.
  2. Select Build -> Build Bundle(s) / APKs(s) -> Build APK(s).
  3. Install APK on device, or use Run menu for attached device.

Running

  1. Configure the BIOS path in the settings.
  2. 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 renderer
  • Page Up/Down: Increase/decrease resolution scale in hardware renderers

Tests

  • Passes amidog's CPU and GTE tests in both interpreter and recompiler modes, partial passing of CPX tests

Screenshots

Final Fantasy 7 Final Fantasy 8 Spyro 2

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.