Play and preserve Sony UMD Video discs straight from .iso or .chd โ no
firmware, no emulator, no extraction.
Pure C++17 ยท FFmpeg + SDL2 ยท zero PSP firmware required
| Windows Media Center Hub | In-player OSD & Settings |
|---|---|
![]() |
![]() |
| Cover-art carousel, category strips, per-disc actions | Glossy auto-hiding transport bar + live Settings overlay |
Native .RCO Disc Menu โ main |
Native .RCO Disc Menu โ chapters |
|---|---|
![]() |
![]() |
The disc's own main_menu page, driven by its VSMX script |
Its chapter1_menu page โ buttons fire the disc's onPush handlers |
All four shots are rendered headlessly (
SDL_VIDEODRIVER=dummy) from a real Region-2 UMD-Video disc (Miku no Hi 39's Giving Day). No copyrighted media is committed โ the PNGs are UI chrome only.
PlayStation Portable game emulation is essentially solved, but UMD Video discs โ PSP movies, concerts and interactive comics โ are still orphaned: emulators boot the game, and generic media players choke on the proprietary Sony packaging.
UMDPlay is the missing playback layer. It opens a UMD .iso/.chd
directly, parses the disc's real filesystem, demuxes the MPEG-PS .MPS
streams in memory with a native, libavformat-free PsmfDemuxer, and decodes
both the H.264 video and the ATRAC3+ audio โ then presents them in a
couch-ready Windows Media Center shell, complete with the disc's own
interactive menus.
The long-term goal is a stable, low-overhead playback core that drops straight into PSP emulators such as PPSSPP (GPLv2 was chosen for exactly this license compatibility).
| Family | Root tree | Contents |
|---|---|---|
| UMD-Video | UMD_VIDEO/ |
.MPS movie/TV streams, PLAYLIST.UMD, .RCO/VSMX menus |
| UMD-Music (UMD-Audio) | UMD_AUDIO/ |
Audio tracks + PLAYLIST.UMD (UMDA0088) |
| UMD-PG | UMD_VIDEO/ |
Interactive visual novels โ a UMD-Video disc under the hood |
| CHD | โ | Any of the above, wrapped in MAME Compressed Hunks of Data |
Disc & container
- ISO 9660/UDF dynamic tree walk โ finds
UMD_VIDEO//UMD_MUSIC/andSTREAM/from the PVD, so discs with non-standard LBAs still load. .isoand.chdthrough oneDiscReaderabstraction (libchdr backend with a decompressed-hunk cache). Byte-identical playback from ISO and CHD.- Reads
PARAM.SFO,PLAYLIST.UMD(UMDV0088/UMDA0088) andCLPI0088clip info.
Decoding
- In-memory MPEG-2 Program Stream demuxing via a native
PsmfDemuxeroverDiscReader(nolibavformat). - H.264 AVC video, with optional 480i
yadifdeinterlacing. - Sony PSMF ATRAC3+ audio reverse-engineered from Private Stream 1
(
0xBD) โ class-byte-agnostic frame sync and a measured frame stride, so both 696-byte (video) and 1720-byte (music) discs decode.
Windows Media Center 10-foot UI
- Recent / Browse / Options strips, cover-art carousel from
ICON0.PNG, per-disc actions, chapters panel and extras sub-menu. - Full player transport: pause/resume, ยฑ10 s / ยฑ30 s and scrub seeking with
keyframe-accurate resync, volume/mute, auto-hiding glossy OSD with
HH:MM:SS. - Touch & gesture input (swipe/drag on the OSD), keyboard and gamepad.
- Procedural UI sound effects โ WMC navigation chimes synthesized at
runtime (no bundled samples); toggle in Options or
--no-ui-sounds.
Native .RCO Disc Menus
- Renders the disc's own
.RCOpages (embedded PNG art) and runs its VSMX bytecode menu VM, so page switches, chapter lists and "play the feature" behave exactly as the disc authored them.
Tooling
--probedisc structure dump,--export-clipheadless MP4 export, and--demo/--demo-playersynthetic-data rendering for CI screenshots.
| Component | Technology | Notes |
|---|---|---|
| Language | C++17 | Modern standard, max compiler compatibility |
| Decoder | FFmpeg libavcodec / libswscale / libswresample |
Native PsmfDemuxer feeds libavcodec; optional libavfilter for yadif (no libavformat) |
| Output & rendering | SDL2 | Software/GPU video, audio, input |
| 10-foot UI | Dear ImGui (SDL2 + SDLRenderer2) | Immediate-mode WMC shell |
| Image decode | stb_image / stb_image_write | PARAM.SFO art (ICON0/PIC1) + PNG screenshots |
| Disc images | ISO 9660/UDF ยท CHD (libchdr) | DiscReader backend chosen by extension |
| Build system | CMake | GCC / Clang / MSVC / MinGW |
Tagged releases ship ready-to-run bundles on the Releases page:
- Linux x86_64 โ
.tar.gz; extract and run./umdplay.sh <disc.iso>(shared libraries bundled). - Windows x86_64 โ
.zip; extract and runumdplay.exe <disc.iso>(MinGW runtime, SDL2 and FFmpeg DLLs bundled). - macOS arm64 (Apple Silicon) โ
.tar.gz; extract and run./umdplay.sh <disc.iso>(Homebrew FFmpeg/SDL2 dylibs bundled, ad-hoc signed). - macOS x86_64 (Intel) โ
.tar.gz; same as above for Intel Macs.
sudo apt-get update
sudo apt-get install -y cmake build-essential pkg-config \
libavcodec-dev libavutil-dev \
libswscale-dev libswresample-dev libsdl2-dev
# Optional: 480i deinterlacing (yadif)
sudo apt-get install -y libavfilter-dev
# Optional: CJK font so Japanese disc titles render
sudo apt-get install -y fonts-noto-cjk
# Optional: ffmpeg CLI, needed only for --export-clip
sudo apt-get install -y ffmpegDear ImGui and stb_image are fetched/vendored automatically by CMake; libchdr
is fetched and statically linked for .chd support.
git clone https://github.com/M5Devs/UMDPlay.git
cd UMDPlay
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j"$(nproc)"
# Play any UMD image directly
./build/bin/umdplay /path/to/movie.iso
./build/bin/umdplay /path/to/movie.chd # CHD works identically
# Tests
cd build && ctest --output-on-failureThe sources are portable to Windows; _WIN32 branches replace the POSIX-only
file-descriptor and process-spawning calls. From an MSYS2 MINGW64 shell:
pacman -S --needed git mingw-w64-x86_64-gcc mingw-w64-x86_64-cmake \
mingw-w64-x86_64-ninja mingw-w64-x86_64-pkgconf \
mingw-w64-x86_64-SDL2 mingw-w64-x86_64-ffmpeg
cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=Release -DUMDPLAY_WERROR=ON
cmake --build build
cd build && ctest --output-on-failureRun umdplay.exe from a MINGW64 shell (or copy the MinGW/SDL2/FFmpeg DLLs
next to it); the release .zip already bundles them.
The sources are portable to macOS (the POSIX branches compile unchanged under Apple Clang). With Homebrew:
brew install cmake pkg-config ffmpeg sdl2
export PKG_CONFIG_PATH="$(brew --prefix)/opt/ffmpeg/lib/pkgconfig:$(brew --prefix)/opt/sdl2/lib/pkgconfig"
cmake -B build -DCMAKE_BUILD_TYPE=Release -DUMDPLAY_WERROR=ON
cmake --build build -j"$(sysctl -n hw.ncpu)"
cd build && ctest --output-on-failureThe release .tar.gz bundles the Homebrew .dylibs (relinked with
dylibbundler), so no Homebrew install is needed at runtime. It is ad-hoc
signed but not notarized: on first launch, right-click the app and choose
Open, or run xattr -dr com.apple.quarantine umdplay.
# Zero-warning build (the CI bar)
cmake -B build-werror -DUMDPLAY_WERROR=ON && cmake --build build-werror -j"$(nproc)"
# Address + Undefined + Leak sanitizers (suppressions in tests/lsan.supp)
cmake -B build-san -DUMDPLAY_SANITIZE=ON && cmake --build build-san -j"$(nproc)"
LSAN_OPTIONS=suppressions="$PWD/tests/lsan.supp" \
ctest --test-dir build-san --output-on-failure# Render a frame off-screen and exit
SDL_AUDIODRIVER=dummy xvfb-run -a -s "-screen 0 1280x720x24" \
./build/bin/umdplay movie.iso --screenshot shot.pngUsage: umdplay [path_to_umd.iso|.chd] [options]
--play start the main feature immediately
--export-clip <mp4> decode a clip to MP4 (H.264/AAC) and exit
--clip-seconds <n> clip length in seconds (default 12)
--screenshot <png> render a frame, write a PNG, then exit
--start <seconds> start at this offset
--fullscreen start in fullscreen (F11 / Alt+Enter toggles)
--strip <name> start on a hub strip: recent|browse|settings
--open-settings open the player Settings overlay
--open-menu open the interactive .RCO Disc Menu
--menu-page <name> start the Disc Menu on a named page
--aspect <mode> zoom mode: auto|16:9|4:3|fill
--no-ui-sounds start with the WMC UI chimes muted
--probe print stream/metadata info and exit
--verbose with --probe: disassemble the menu VSMX script
--demo render the hub with synthetic data (no disc image)
--demo-player render the player OSD over synthetic video (no disc)
Inspect a disc
./build/bin/umdplay movie.iso --probe # filesystem, streams, playlist, RCO
./build/bin/umdplay movie.iso --probe --verbose # + VSMX menu disassemblyExport a clip (headless A/V decode proof)
# ~12 s from the middle of the movie, muxed to a playable MP4
./build/bin/umdplay movie.iso --export-clip test_clip.mp4 --start 3552 --clip-seconds 12
ffprobe test_clip.mp4The default front-end is a couch-friendly WMC shell. It launches in a clean resizable 1280ร720 window; press F11 / Alt+Enter to toggle fullscreen.
Three horizontal strips, switched with LEFT / RIGHT:
| Strip | Contents |
|---|---|
| Recent Discs | Every disc you have opened, persisted to ~/.config/umdplay/recent.txt (override with $UMDPLAY_CONFIG_DIR), shown as cover-art cards from ICON0.PNG. |
| Browse System | A built-in std::filesystem browser; filters to *.iso / *.chd and opens any UMD image. |
| Options | Display Mode, Audio Volume, Mute and the UI Sounds toggle. |
Per-disc actions replace the raw .MPS list with clean choices โ Play (the
main feature), Extras (bonus streams, when present) and Options.
LEFT / RIGHT switch strip (tabs) / move cards / adjust a setting
UP / DOWN move between tabs, cards and action rows
ENTER / SPACE open disc, enter folder, activate action
BACKSPACE Browse: up one directory
F11 / Alt+Enter toggle fullscreen
ESC back one level (Hub) / return to Hub (player)
Q quit
The glossy transport bar fades in on any input and auto-hides after ~3 s of inactivity โ but never while paused or hovered.
SPACE play / pause (video clock + SDL audio pause together)
LEFT / RIGHT seek -10 s / +10 s
SHIFT+LEFT/RIGHT seek -30 s / +30 s
drag the timeline scrub to any position
UP / DOWN volume -5% / +5%
M mute / unmute
T open the Disc Menu (when the disc ships one)
PageUp / [ previous chapter PageDown / ] next chapter
F11 / Alt+Enter toggle fullscreen
ESC / BACKSPACE stop and return to the Hub
Chapters come from PLAYLIST.UMD: the hub's Chapters action opens a marker
list, and the transport carries |< / >| buttons plus a CH n/N readout.
When a disc ships an interactive menu (RESOURCE/*.RCO), the OSD grows a
Menu button and T opens the Disc Menu: the disc's own .RCO pages,
drawn from embedded PNG art, navigated with the arrows / D-pad (mouse hover and
touch taps focus directly). Each button fires the page's own VSMX onPush
handler, so page switches (pageID), chapter lists and "play the feature" all
behave as authored. The focused button shows its _sel artwork and a glowing
ring; ESC/B steps back (or leaves at the top level), ENTER/A activates.
include/ ยท src/ C++17 modules โ iso_reader, disc_reader, psmf_demuxer,
decoder, param_sfo, playlist_parser, rco_parser, vsmx_vm,
rco_menu, wmc_ui, ui_sfx, clip_export, ui_manager
tests/ ctest suites (10) + fixtures + lsan.supp
docs/ ARCHITECTURE.md ยท TESTED_DISCS.md ยท CHD_GUIDE.md
screenshots/ README showcase images (headless renders)
third_party/ vendored stb_image
| Document | Contents |
|---|---|
docs/ARCHITECTURE.md |
Reverse-engineered UMD internals โ UDF layout, PARAM.SFO, PLAYLIST.UMD (UMDV0088), CLPI0088, .RCO (\0PRF) + VSMX bytecode, Sony PSMF ATRAC3+ (0xBD) framing |
docs/TESTED_DISCS.md |
Every real disc tested, what it exercised, and the bugs each one exposed (compatibility matrix) |
docs/CHD_GUIDE.md |
Safe UMD ISO โ CHD compression โ sector specs, the exact chdman createdvd command, verifying and restoring |
AGENTS.md |
Module map, build/test/CI commands and the technical gotchas for anyone (human or AI) working on the code |
A UMD is a 2048-byte-sector, single-track, DVD-style disc, so it must be
compressed in DVD mode. Use createdvd โ never createcd:
chdman createdvd -i movie.iso -o movie.chd # โ
correct for UMD
chdman verify -i movie.chd # confirm the copy is intact
chdman extractdvd -i movie.chd -o movie.iso # lossless restore, byte-identical
# โ chdman createcd -i movie.iso -o movie.chd (2352-byte CD mode โ breaks the image)If chdman info -i movie.chd reports Unit Size: 2048 you did it right.
Full details in the CHD Compression Guide.
- Phase 1 โ ISO & UDF Parser: navigate
UMD_VIDEO/STREAM/, resolve LBAs dynamically. - Phase 2 โ Streaming & Decoding: native in-memory
PsmfDemuxer, H.264 AVC, PSMF ATRAC3+ reverse-engineering. - Phase 3 โ Standalone Player + WMC UI: synced A/V playback, WMC 10-foot shell, headless clip export.
- Phase 4 โ Interactive Menus & Chapters:
PLAYLIST.UMD/CLPI0088, real chapters,.RCOobject tree + VSMX menu VM. - Phase 4.5 โ Unified
DiscReader: ISO + CHD via libchdr. - Phase 6 (Step 1) โ FFmpeg Independence: native
PsmfDemuxerreplaceslibavformatdemuxing (ISO + CHD). - Phase 5 โ PPSSPP integration: expose a clean C-style API for native upstream integration.
Licensed under the GNU General Public License v2.0 (GPLv2) โ chosen
specifically for license compatibility with PPSSPP, enabling clean upstream
integration without legal friction. See LICENSE.
Disclaimer: This project is strictly for digital preservation and educational purposes. "PSP" and "UMD" are trademarks of Sony Interactive Entertainment Inc.




