PLAYSTATION EMULATOR
pseudo
PSeudo — a small open-source PlayStation (PSX) emulator project focused on simplicity and learning; actively developed on macOS with experimental Windows support and prebuilt macOS releases available.

WHY IT MATTERS
Why PSeudo exists
PSeudo aims to be "the world's simplest PLAYSTATION emulator" both as a user-facing app and as a compact, readable software implementation intended for experimentation and incremental improvement.
BEST FOR
What PSeudo does now
The repository implements a large portion of a PSX stack (MIPS R3000A CPU interpreter, DMA, memory I/O, GPU primitives, CD and movie decoding, basic audio and GTE). The author reports the emulator can load some commercial games but notes work remains on timing and performance. Primary development and tested platform is macOS; there are Windows experiments.
The people behind pseudo
History and status
PSeudo is a single-repository, Apache-2.0 licensed project with many commits and ongoing development by the repository owner. The README lists per-component completion percentages (for example ~95% CPU, ~90% DMA, ~70% GPU primitives) and explicitly states the project has been developed on a Mac and currently works on macOS while Windows support is experimental and requires work on the OpenGL path. The project provides prebuilt macOS releases via the GitHub Releases page and instructions to build on macOS and Windows. The author cautions that timing and performance still need improvement and not all subsystems (serial, XA audio, etc.) are complete.
What pseudo supports
- macOS (primary, prebuilt release available)
- Windows (experimental; source builds/experiments present)
- Cross-platform source code (C/C++ using OpenGL and OpenAL; further ports possible)
- PlayStation (PSX / PS1)
Download and availability
OFFICIAL DOWNLOADS
Get pseudo
Official code and releases are hosted on the project's GitHub repository. Prebuilt macOS releases are available from the repository's Releases page. Source is under the Apache 2.0 license for building yourself.
Get pseudo ↗DOCUMENTATION
Official documentation
Read the official configuration, compatibility, and troubleshooting material before changing advanced options.
Read official documentation ↗pseudo setup guide
Setup note: This guide explains how to obtain and build or run PSeudo from the official repository. It focuses on verified steps from the project's README: macOS is the primary supported platform; Windows builds are experimental and require extra toolchain setup. The project does NOT include commercial games, BIOS, or firmware — you must provide legally obtained game images and any required BIOS files yourself.
- Get the official source or a prebuilt macOS release: Visit the project's GitHub page and open Releases. For macOS, the README advertises a prebuilt 0.87 macOS release; download that release artifact if you want the easiest path. If you prefer to build from source, clone the repository to your machine.
- macOS: prerequisites: The README states the project was developed on macOS and requires Xcode 10 or newer to build. Install Xcode (or the Command Line Tools) and confirm you can build C/C++ projects. The code uses OpenGL for graphics and OpenAL for audio, so ensure any system headers/libs are available (Xcode supplies them).
- macOS: build from source: Clone the repository, open the provided Xcode project or build scripts (see repository root/Platforms folders), and build with Xcode 10+. Use the build target that corresponds to the macOS app. If you downloaded a prebuilt release, extract and run the app bundle. The README and Platforms folder are the authoritative place for exact build targets and minor flags.
- Windows: prerequisites: The README recommends Microsoft Visual Studio 2019 plus an additional Clang toolchain; the project uses Clang on Windows so the source remains similar across platforms. You will also need development libraries for OpenGL and OpenAL and any Windows-specific build scripts or CMake configuration present in the Platforms folder.
- Windows: build notes: Open the repository’s Windows/Platforms project or CMake files, configure the toolchain to use Clang as the compiler (as documented in the README), and build inside Visual Studio 2019. The README warns the OpenGL implementation and other platform-specific pieces still need work, so expect to troubleshoot graphics initialization and audio routing.
- Running games and BIOS: PSeudo can load some commercial PSX games according to the README, but it does not bundle any commercial games, BIOS, or firmware. If a BIOS image is required by the emulator, obtain it legally from your own hardware and place it where the emulator expects (check the project's Resources or configuration files for the exact expected filename/location).
- Troubleshooting and testing: Because timing and performance are explicitly noted as incomplete, start with small homebrew or simpler commercial titles to test behavior. Check the repository Issues and commit history for known problems. If building on Windows, expect OpenGL differences to affect rendering and coordinate with the project's source for fixes.
- Contributing and building safely: Follow the license (Apache 2.0) and the repository's contribution workflow. Use the author's preferred toolchain (Xcode on macOS, Clang via Visual Studio on Windows) to keep builds consistent. Do not distribute BIOS or commercial game images with your builds.
Software reminder: PSeudo is open-source but incomplete; expect to build from source or use the macOS release. The project does not include BIOS or game images — supply those legally. Consult the GitHub README and Platforms folders for up-to-date build details.
Sources and further reading
Detailed guides and tutorials
Explore step-by-step guides for pseudo as they are published.
Retro Replay Retro Gaming History, Reviews & Emulation
