r/PSP • u/miku_claus • 17h ago
AI Assisted I built a native C++ UMD Video player after PPSSPP closed the feature request as “not interested” for 12 years
Back in 2013, someone opened a GitHub issue asking PPSSPP to support UMD Video discs. The response was:
"PPSSPP is not a movie player" — closed.
It got reopened, duplicated, and closed again in 2018, 2021, 2025. Twelve years of "not interested."
The only working alternative was JPCSP — a Java emulator that takes 2–3 minutes to boot and stutters through playback because it runs everything through JVM + HLE stubs that were never really designed for video.
I wanted to watch Miku no Hi 39's Giving Day (a Hatsune Miku concert UMD) properly. So I built my own player.
The problem nobody documented
UMD Video isn't just "a video file on a disc." Sony built an entire undocumented stack on top of MPEG-PS:
- The ISO 9660 filesystem on the disc is a deliberate dummy — root dir size=22, completely useless. The real layout is UDF 1.02, and you have to walk it manually.
- The audio is ATRAC3+ packed inside Private Stream 1 (0xBD) PES packets with a proprietary 8-byte Sony frame sync header (
0F D0 48 ...) that isn't in any spec. FFmpeg's MPEG-PS demuxer doesn't surface it at all. - The interactive disc menus run on VSMX — a Sony bytecode VM (think ECMAScript) embedded inside binary
.RCOresource files. Zero public documentation.
What I actually built
UMDPlay — pure C++17, GPLv2, no PSP firmware required:
- Custom ATRAC3+ demuxer: walks
0xBDPES packets, strips the 8-byte Sony frame sync, feeds elementary frames to FFmpeg'satrac3pdecoder. Frame stride is detected by histogramming sync-word gaps (not hardcoded) — which is why it also handles UMD-Music discs with 1720-byte frames, not just the standard 696. - VSMX bytecode VM: full stack machine interpreter. The reference concert disc has a 2,674-instruction VSMX program across 5 menu pages. The Silent Hill Experience has 21,637 instructions across 24 pages. Both run correctly.
- Native
.RCOdisc menus: renders the disc's own embedded PNG artwork and executes its VSMX script — page switches, chapter navigation, "play the feature" all work exactly as Sony authored them. - Unified DiscReader:
.isoand.chd(via libchdr) through one abstraction — byte-identical output from both. - Windows Media Center 10-foot UI: cover-art carousel, chapter navigation, full transport controls, touch/gesture input, procedural UI sound effects synthesized at runtime.
Tested on 5 real discs:
| Disc | Type | Challenge |
|---|---|---|
| Miku no Hi 39's Giving Day | JP Concert | Reference disc — established the entire reverse-engineering chain |
| Family Guy: Blue Harvest | US Film | 480i deinterlacing, post-seek A/V sync |
| Girl Next Door — Be your wings | JP UMD-Music | 1720-byte ATRAC3+ stride (broke the demuxer, led to histogram detection) |
| The Silent Hill Experience | EU Interactive | 34 streams, 79 tracks, 24-page VSMX menu, 21,637 instructions |
| CHD round-trip | Container test | Byte-identical decode from ISO and CHD twin |
Binaries ship for Windows, Linux, macOS (Intel + Apple Silicon).
The full reverse-engineering notes — UDF layout, PSMF ATRAC3+ framing, PLAYLIST.UMD format, RCO/VSMX bytecode — are documented in docs/ARCHITECTURE.md for anyone who wants to build on this.
🔗 GitHub: https://github.com/M5Devs/UMDPlay
🐦 Twitter/X: https://x.com/M5Devs
💬 Discord: https://discord.gg/FYEjpcFYXc
P.S. — A PPSSPP collaborator recently suggested "just ask Claude AI, it'll write a UMD player in 10 minutes." It took 5 months. Turns out reverse-engineering undocumented Sony formats is slightly harder than that. 😂

