A Rust and egui based front-end for the SwanStation PS1 Libretro core
  • C++ 58.4%
  • C 36.7%
  • Rust 2.2%
  • HLSL 0.7%
  • GLSL 0.6%
  • Other 1.2%
Find a file
2021-10-25 02:11:11 +02:00
.github/workflows Update Bug Report! 2021-10-05 17:58:49 -03:00
CMakeModules CMake: Build system support for FreeBSD 2021-03-07 19:35:02 +10:00
data Update bundled SDL game controller database 2021-09-21 10:05:30 +10:00
dep reapply swanstation commits to latest upstream 2021-10-14 23:30:13 +02:00
extras Extras: Sync translation xml 2021-08-18 13:33:42 +10:00
gamedb GameDB: Actually fix SLES-00107 2021-08-23 02:28:44 +10:00
scripts generate a wayland appimage (#2625) 2021-09-26 09:56:56 +10:00
src Changed the way BIOS loading works, as well as hide some options when not applicable 2021-10-25 02:11:11 +02:00
.clang-format clang-format: Enable brace wrapping after case label 2020-01-24 14:49:43 +10:00
.gitattributes Initial commit 2019-09-11 14:00:42 +10:00
.gitignore Sync Android strings 2021-07-17 20:14:40 +10:00
.gitlab-ci.yml Add CD for libretro 2021-07-28 15:38:46 +07:00
.gitmodules .gitmodules: Use shallow clone 2020-08-02 17:36:52 +10:00
CMakeLists.txt Add regression test runner 2021-07-24 00:02:09 +10:00
CMakeSettings.json Initial commit 2019-09-11 14:00:42 +10:00
CONTRIBUTORS.md Update compatibility list 2021-09-01 15:01:39 +10:00
duckstation-uwp.sln Add UWP frontend 2021-07-11 15:20:38 +10:00
duckstation.sln Add regression test runner 2021-07-24 00:02:09 +10:00
LICENSE Initial commit 2019-09-11 14:00:42 +10:00
NEWS.md Update news 2021-07-26 01:37:16 +10:00
README.md Fix small spelling mistake 2021-10-15 17:36:49 +02:00
README.pt-br.md Update README.pt-br.md to match README.md modifications 2021-10-15 17:36:06 +02:00

SwanStation - PlayStation 1, aka. PSX Emulator

Latest News | Features | Disclaimers

Latest Builds for Windows, MacOS and Linux https://github.com/libretro/swanstation/releases

Game Compatibility List: https://docs.google.com/spreadsheets/d/1H66MxViRjjE5f8hOl5RQmF5woS1murio2dsLn14kEqo/edit

SwanStation is a fork of DuckStation, which is an emulator of the Sony PlayStation(TM) console, focusing on playability, speed, and long-term maintainability. The goal is to be as accurate as possible while maintaining performance suitable for low-end devices. "Hack" options are discouraged, the default configuration should support all playable games with only some of the enhancements having compatibility issues.

A "BIOS" ROM image is required to to start the emulator and to play games. You can use an image from any hardware version or region, although mismatching game regions and BIOS regions may have compatibility issues. A ROM image is not provided with the emulator for legal reasons, you should dump this from your own console using Caetla or other means.

Latest News

Older entries are available at https://github.com/libretro/swanstation/blob/master/NEWS.md

  • 2021/07/25: Ability to boot games directly from CD-ROM added. You may want to reduce the readahead size to reduce hitches on seek/loading.
  • 2021/07/11: UWP/Xbox one port added. Follow the instructions in "Universal Windows Platform / Xbox One" below.
  • 2021/07/10: Direct3D 12 hardware renderer added. It does not support downsampling or postprocessing (was mainly intended for Xbox).
  • 2021/06/25: Ability to undelete files from memory card editor added.
  • 2021/06/22: Measured achievements for RetroAchievements added.
  • 2021/06/19: Leaderboards for RetroAchievements added.
  • 2021/06/01: Auto loading/applying of PPF patches added.
  • 2021/05/23: Save RAM (srm) support added to libretro core.
  • 2021/05/23: CD-ROM seek speedup enhancement added.
  • 2021/05/16: Auto fire (toggle pressing) buttons added.

Features

SwanStation features include:

  • CPU Recompiler/JIT (x86-64, armv7/AArch32 and AArch64)
  • Hardware (D3D11, D3D12, OpenGL, Vulkan) and software rendering
  • Upscaling in both hardware and software renderers
  • Texture filtering, and true colour (24-bit) in hardware renderers
  • PGXP for geometry precision, texture correction, and depth buffer emulation
  • Adaptive downsampling filter
  • Post processing shader chains
  • "Fast boot" for skipping BIOS splash/intro
  • Save state support
  • Supports bin/cue images, raw bin/img files, MAME CHD, single-track ECM, MDS/MDF, and unencrypted PBP formats.
  • Direct booting of homebrew executables
  • Direct loading of Portable Sound Format (psf) files
  • Digital and analog controllers for input (rumble is forwarded to host)
  • Namco GunCon lightgun support (simulated with mouse)
  • NeGcon support
  • Emulated CPU overclocking
  • Multitap controllers (up to 8 devices)
  • RetroAchievements
  • Automatic loading/applying of PPF patches

System Requirements

  • A CPU faster than a potato. But it needs to be x86_64, AArch32/armv7, or AArch64/ARMv8, otherwise you won't get a recompiler and it'll be slow.
  • For the hardware renderers, a GPU capable of OpenGL 3.1/OpenGL ES 3.0/Direct3D 11 Feature Level 10.0 (or Vulkan 1.0) and above. So, basically anything made in the last 10 years or so.

Region detection and BIOS images

By default, SwanStation will emulate the region check present in the CD-ROM controller of the console. This means that when the region of the console does not match the disc, it will refuse to boot, giving a "Please insert PlayStation CD-ROM" message. SwanStation supports automatic detection disc regions, and if you set the console region to auto-detect as well, this should never be a problem.

The region checking can be disabled in the console options tab. This is the only way to play unlicensed games or homebrew which does not supply a correct region string on the disc, aside from using fastboot which skips the check entirely.

Mismatching the disc and console regions with the check disabled is supported, but may break games if they are patching the BIOS and expecting specific content.

LibCrypt protection and SBI files

A number of PAL region games use LibCrypt protection, requiring additional CD subchannel information to run properly. libcrypt not functioning usually manifests as hanging or crashing, but can sometimes affect gameplay too, depending on how the game implemented it.

For these games, make sure that the CD image and its corresponding SBI (.sbi) file have the same name and are placed in the same directory. SwanStation will automatically load the SBI file when it is found next to the CD image.

For example, if your disc image was named Spyro3.cue, you would place the SBI file in the same directory, and name it Spyro3.sbi.

Tests

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

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.