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
LibretroAdmin cd5d83db9f byte_stream: fix Windows atomic save leaving .tmp behind (stale saves)
The VFS conversion (db694177) broke the atomic-update save path on
Windows.  The pre-VFS code opened the temporary with CreateFileW and
FILE_SHARE_DELETE - the load-bearing flag that let MoveFileExW rename
it over the original while still open, and let DeleteFileW reap a
discarded temporary.  rfopen() maps to _wfopen, which shares
READ|WRITE but never DELETE, so Commit()'s rename of the open .tmp
fails with a sharing violation, m_discarded is set, the destructor's
remove() fails for the same reason, and the new memory-card data is
stranded in <save>.srm.tmp while the stale .srm loads next session.
Independently, the plain rename() also lost MOVEFILE_REPLACE_EXISTING:
MSVCRT rename cannot replace an existing destination even on a closed
file, so overwriting an existing save was doubly broken.

Fix:
- Commit() now flushes and closes the handle before renaming, and
  routes the rename/delete through filestream_rename/filestream_delete
  so frontend-backed paths work too.  If the backend's rename lacks
  replace-existing semantics, fall back to delete-then-rename (the
  atomic single-rename is preserved wherever the backend supports it).
- The destructor closes before deleting a discarded temporary, and
  the base FileByteStream tolerates an already-closed handle.
- vfs_implementation.c (ahead of upstream): the Win32 rename impl now
  uses MoveFileExW(MOVEFILE_REPLACE_EXISTING) instead of _wrename,
  restoring POSIX overwrite semantics for every rename caller.
- The temporary is now always created fresh: the old append-mode
  passthrough maps to VFS UPDATE_EXISTING, which fails when the .tmp
  does not yet exist, so non-truncating atomic opens could never
  create their temporary (also broken by db694177; no in-tree caller
  hit it since memory cards open with TRUNCATE).

Verified: ASan/UBSan lifecycle test covering fresh save, overwrite,
discard, destructor-driven commit, non-truncate copy-in, and double
commit - all green, no .tmp litter; mingw-w64 syntax check confirms
the Win32 branches compile.
2026-08-11 17:16:23 +02:00
CMakeModules Remove unused files 2023-03-25 17:43:35 +01:00
data/shaders core/d3d: fix box downsample PS signature for D3D12 PSO linkage 2026-05-20 13:36:44 +02:00
dep byte_stream: fix Windows atomic save leaving .tmp behind (stale saves) 2026-08-11 17:16:23 +02:00
src byte_stream: fix Windows atomic save leaving .tmp behind (stale saves) 2026-08-11 17:16:23 +02:00
tools core: pre-bake the batch vertex shader; D3D12 is now D3DCompile-free 2026-05-20 07:26:40 +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 byte_stream: fix Windows atomic save leaving .tmp behind (stale saves) 2026-08-11 17:16:23 +02:00
.gitlab-ci.yml Merge pull request #167 from cscd98/webos-ci 2026-04-10 05:12:17 +02:00
CMakeLists.txt build: add MSB_FIRST opt-in flag for big-endian hosts 2026-05-08 00:32:03 +02:00
libretro.osx.def libretro: add static Makefile.libretro build 2026-05-07 21:32:02 +02:00
LICENSE Initial commit 2019-09-11 14:00:42 +10:00
link.T libretro: add static Makefile.libretro build 2026-05-07 21:32:02 +02:00
Makefile.libretro libretro-common: sync with upstream, VFS v4 hybrid, data_transfer I/O overhaul 2026-08-11 07:16:40 +02:00
README.md Documentation OpenBIOS usage in the README. 2026-04-02 10:46:10 +01:00
TODO Update TODO 2026-06-27 01:44:04 +02:00

SwanStation - PlayStation 1, aka. PSX Emulator

Features | System Requirements | Disclaimers

SwanStation is a hard fork and open-source Libretro core implementation 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 can be used, but is not required. 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. If no ROM image is provided, OpenBIOS will be used instead.

Features

SwanStation features include:

  • CPU Recompiler/JIT (x86-64, armv7/AArch32 and AArch64)
  • Hardware (D3D11, OpenGL, Vulkan) and software rendering
  • Upscaling, 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 2013 or later.

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

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