From ef34e5090f93706d47c6c2ff5ee8ecdde933b3e5 Mon Sep 17 00:00:00 2001
From: Mihawk <163614687+mihawk-99@users.noreply.github.com>
Date: Fri, 2 Oct 2026 13:40:55 -0400
Subject: [PATCH] Present the WebUI first in the project README
Lead with a real console Overview screenshot and port6769 URL legend.
Organize setup, guided global/core settings, systems, balanced graphics and
file locations before developer details. Preserve licensing and attribution;
separate source-build features from release availability and remove game names.
Validation: desktop/mobile GitHub-style previews, no page overflow or missing
image; actual Overview inspected; Impeccable finish review and final delta ship.
Screenshot provenance embedded. Evidence: evidence/readme-overview, replay with
python3 tools/evidence.py compare evidence/. All project gates passed this round.
---
README.md | 565 +++++++---------------
assets/readme/webui-overview.png | Bin 0 -> 130145 bytes
evidence/readme-overview/capture.json | 17 +
evidence/readme-overview/expectation.json | 13 +
4 files changed, 199 insertions(+), 396 deletions(-)
create mode 100644 assets/readme/webui-overview.png
create mode 100644 evidence/readme-overview/capture.json
create mode 100644 evidence/readme-overview/expectation.json
diff --git a/README.md b/README.md
index 87ff1b2..ad3c225 100644
--- a/README.md
+++ b/README.md
@@ -1,293 +1,195 @@
-# PS5 RetroArch 🎮
+
-**Native RetroArch for jailbroken PlayStation 5 consoles, rendering through
-[PS5_Vulkan](https://github.com/mihawk-99/PS5_Vulkan)'s port of Mesa's RADV
-Vulkan driver.**
+# RetroArch for PS5
-Maintained by [Mihawk](https://github.com/mihawk-99). Based on
-[RetroArch / libretro](https://github.com/libretro/RetroArch), with a native PS5
-application foundation derived from
-[ProsperoLight](https://github.com/blackbearreloaded/ProsperoLight).
+**Your collection on the console. Your controls in the browser.**
-> [!IMPORTANT]
-> **Piracy is not condoned.** This project ships no games, no BIOS files, no
-> console firmware and no decryption keys, and never will. Use only **legally
-> obtained backups of games you own**, made yourself from your own discs,
-> cartridges or digital purchases, and BIOS or firmware files dumped from
-> **hardware you own**. Requests for, or links to, games, BIOS files, firmware
-> or keys are not welcome in this project's issues or discussions.
->
-> **PlayStation 3 (RPCS3) is not in any release.** RPCS3 is licensed
-> GPL-2.0-only and this port is GPL-3.0-or-later: the two cannot be distributed
-> together as one program. Its source is public, and **you must compile it
-> yourself from source** for your own console (see
-> [PlayStation 3 (RPCS3): build it yourself](#playstation-3-rpcs3-build-it-yourself)).
-> Do not share or redistribute the binaries you build.
+Native Vulkan rendering · Fifteen release cores · A local WebUI
-The title launches as a homebrew title, presents XMB through RetroArch's Vulkan
-video driver, and runs fifteen native libretro cores in its releases, six of
-them (PSP, GameCube/Wii, PlayStation 2, PlayStation, Nintendo 64 and Nintendo
-3DS) rendering on the PS5's GPU. A sixteenth, RPCS3 (PlayStation 3), is
-available only as source that you build yourself. Input, stereo audio,
-configuration persistence and content browsing have been verified on a
-console. This is an active development project; the tested paths below do not
-imply complete core compatibility or Vulkan conformance.
+[Download a release](https://github.com/mihawk-99/PS5_RetroArch/releases) · [Get started](#get-started) · [Supported systems](#supported-systems) · [Build from source](#build-from-source)
-**Latest release: v0.5.7-alpha.5** (a new 4K launcher background; otherwise
-v0.5.6-alpha.5) — see its
-[release notes](https://github.com/mihawk-99/PS5_RetroArch/releases/tag/v0.5.7-alpha.5)
-and [every release](https://github.com/mihawk-99/PS5_RetroArch/releases).
-v0.5.0-alpha.5 was the first release on RADV; v0.4.0-alpha.4 was the last on
-ps5vk, the project's first driver.
+
-## Table of contents
+
-- [Current status](#current-status)
-- [Available cores](#available-cores)
-- [Graphics and native runtime](#graphics-and-native-runtime)
-- [Roadmap](#roadmap)
-- [Build from source](#build-from-source)
-- [Install and file locations](#install-and-file-locations)
-- [WebUI](#webui)
-- [Testing and troubleshooting](#testing-and-troubleshooting)
-- [Documentation](#documentation)
-- [Authors and acknowledgements](#authors-and-acknowledgements)
-- [License and third-party terms](#license-and-third-party-terms)
+WebUI Overview · Open http://<PS5-IP>:6769 while RetroArch is running.
Replace <PS5-IP> with your console’s local address. Use a browser on the same network.
-## Current status
+A native RetroArch homebrew title for jailbroken PlayStation 5 consoles, made by
+[Mihawk](https://github.com/mihawk-99). Play through XMB on your TV, then upload
+content, browse your library and adjust settings from your phone or computer.
+The purple WebUI starts with RetroArch and closes with it.
-| Feature | Status |
+**Development status:** this README describes the current source build. The WebUI,
+guided settings and recent stability changes are development features; consult
+[release notes](https://github.com/mihawk-99/PS5_RetroArch/releases) for what a
+particular download includes. Compatibility varies by core and workload.
+
+## Get started
+
+1. **Install the complete title folder.** Extract a release and copy its
+ `PPSA99169` folder to the location used by your homebrew launcher. The tested
+ location is `/data/homebrew/PPSA99169/`. A source build produces the same
+ folder in `dist/`. A compatible jailbreak and launcher must already be set up.
+2. **Open RetroArch.** It creates its writable folders and initial configuration.
+ Existing settings are preserved. XMB is the default menu; RGUI is also available.
+3. **Open the WebUI.** Visit `http://:6769` on the same network.
+ Choose a destination and drop your content into **Upload content**, or use FTP.
+4. **Load content on the console.** Select the matching core and your file.
+ Install any required BIOS files first, using the locations below.
+
+No games, BIOS files, firmware or decryption keys are included. Use your own
+legally obtained backups and system files dumped from hardware you own. Piracy
+is not condoned; requests for these files are not welcome in issues or discussions.
+
+## A browser companion, built in
+
+| Page | What you can do |
| --- | --- |
-| Native title startup and Quit | ✅ Working, including splash dismissal and clean native exit |
-| Vulkan video output | ✅ Menu and software-core frames presented through RADV, Mesa's Vulkan driver, linked into the title (PS5_Vulkan's port, reporting Vulkan 1.4). ps5vk remains a build option |
-| XMB | ✅ Default menu, with icons, fonts and background rendering |
-| RGUI | ✅ Alternative menu |
-| Native controller input | ✅ Buttons, left-stick menu navigation and button/axis binding capture |
-| Controller feedback | Core rumble drives synthesized DualSense haptics, with ordinary rumble fallback if the haptic path fails. Native streaming verified; physical feel awaits confirmation. Inspired by [PR #6](https://github.com/mihawk-99/PS5_RetroArch/pull/6). |
-| Native audio | ✅ `audio_ps5` stereo PCM output, audible channel test and buffering diagnostics |
-| Filesystem and configuration | ✅ Directory browsing, configuration loading/saving and FTP-writable application folders |
-| Core loading | ✅ Native shared-core loader, official `.info` discovery and recovery from rejected loads |
-| Content loading | ✅ Tested games and archives with the cores below. Load Content opens two roots: **INTERNAL**, the title's folder, and **EXTERNAL**, the console's `/mnt`, where USB drives and extended storage mount. The title's sandbox hides `/mnt` for now, so EXTERNAL is empty |
-| Colour and menu transitions | ✅ Corrected pixel uploads; Quick Menu/Close Content/next-game transitions I verified on the console |
-| Hardware-rendered cores | ✅ PPSSPP, Dolphin, LRPS2, Beetle PSX HW, Mupen64Plus-Next (ParaLLEl-RDP) and Azahar render on RADV through their Vulkan renderers, with JITs where they have them, at up to 18× internal resolution; PPSSPP's MSAA renders, with the save-state caveat below |
-| Shader cache | ✅ RADV keeps compiled pipelines in `radv-shader-cache/`: a game's next start reads them back instead of compiling |
-| Save states and fast-forward | ✅ Save/load states (including `--entryslot`) and fast-forward, tested with PPSSPP and mGBA |
-| 120 Hz output | ✅ 120 Hz by default where the display offers it; the refresh is measured, and a display that stays at 60 Hz gets 60 Hz |
-| Stability | ✅ On RADV (v0.5.6-alpha.5): every core in the release with its game through boot, the menu opened and closed twice, Close Content and a reload, at full speed before and after, with no crash (Beetle Saturn without a BIOS, so up to its BIOS check); earlier releases also passed a 10-minute PPSSPP soak with 25 menu toggles |
-| CPU video fallback | ✅ `video_ps5` remains registered and selectable |
-| Development diagnostics | ✅ `retroarch.log`, startup/GPU trace, kernel captures and optional buffered frame timing |
+| **Overview** | Check release status, read what’s new, upload content and reach your library and quick settings. Development builds identify themselves honestly. |
+| **Content** | Browse folders, create subfolders, upload and download files. Uploads stream to storage, can be cancelled and never overwrite an existing filename. |
+| **Transfers** | Follow upload progress and results for this browser session. Downloads use your browser’s download manager. |
+| **Settings** | Edit global preferences or select a core profile. Guided categories explain each setting and offer supported choices; Advanced exposes technical keys and manual values. |
-The v0.5.6-alpha.5 checks recorded no crash and no kernel fatal signal, and
-full-speed audio once each game had booted. These results apply to the tested
-games, not every possible workload; the release notes list them, and
-[committed evidence](evidence/) holds earlier captures.
+Guides cover all **15 release cores**, even before their first launch. Global
+preferences cover Video, Audio, Input, Saving, System and Interface. Core
+categories follow each emulator’s options. Runtime-specific choices, including
+BIOS lists and arcade switches, appear when the core registers them.
-## Available cores
+**Save settings, then restart RetroArch to apply them.** Global preferences,
+core options and per-core RetroArch overrides are separate. Existing game or
+folder overrides can take precedence. Unsaved edits survive switching categories
+or Guided/Advanced mode. WebUI light/dark appearance changes immediately.
-The title build includes these cores and their official metadata. FCEUmm,
-mGBA, Snes9x, FBNeo, Genesis Plus GX, Beetle Saturn, VICE, MAME and DeSmuME
-**render emulated games in software**; RetroArch uploads their frames and presents
-them through Vulkan. PPSSPP, Dolphin, LRPS2, Beetle PSX HW, Mupen64Plus-Next and
-Azahar **render on the GPU** through RADV, with their Vulkan renderers.
+The interface, fonts and artwork are served locally; only release checking needs
+internet access. Updates are announced, not installed automatically. Uploads are
+limited to the content folder and 64 GiB per file. Available storage is not
+reported because the console API does not provide a measured value.
-The frontend now supplies balanced defaults for a 4K display. Internal rendering
-can be below 4K to leave GPU and memory headroom; RetroArch presents the result
-at the display resolution. These are starting settings, not a guarantee that
-every game runs at full speed. The console results in the table below describe
-previous tests, including the former showcase settings.
+> The WebUI is a local HTTP service without a login. Use a trusted network and
+> do not forward port **6769** to the internet.
-| Core | Balanced internal resolution | Anti-aliasing |
+## Supported systems
+
+Release builds contain the following native cores. “GPU” means the emulator
+renders through Vulkan; “software” means RetroArch presents the core’s frames
+through Vulkan. These are supported systems, not a promise that every title works.
+
+| Systems | Core | Rendering |
| --- | --- | --- |
-| PPSSPP | 6× (2880×1632) | 8× MSAA |
-| Dolphin | 4× | Core default (no MSAA) |
-| LRPS2 | 4× (~1440p) | Core default |
-| Beetle PSX HW | 8× | MSAA off (1×) |
-| Mupen64Plus-Next | 4× (unchanged) | Core default |
-| Azahar | 6× (2400×1440 top screen) | Core default |
-| DeSmuME | 4× (1024×768 per screen) | Core default |
+| NES / Famicom | FCEUmm | Software |
+| Game Boy / Game Boy Color / Game Boy Advance | mGBA | Software |
+| SNES / Super Famicom | Snes9x | Software |
+| Arcade, including Neo Geo and Sega System 16/32 | FinalBurn Neo | Software |
+| Mega Drive / Genesis, Master System, Game Gear, SG-1000, Sega CD | Genesis Plus GX | Software |
+| PlayStation Portable | PPSSPP | GPU |
+| GameCube / Wii | Dolphin | GPU |
+| PlayStation 2 | LRPS2 | GPU |
+| PlayStation | Beetle PSX HW | GPU |
+| Nintendo 64 | Mupen64Plus-Next | GPU |
+| Sega Saturn | Beetle Saturn | Software |
+| Commodore 64 | VICE x64sc | Software |
+| Arcade | MAME | Software |
+| Nintendo DS | DeSmuME | Software |
+| Nintendo 3DS | Azahar | GPU |
-FCEUmm, mGBA, Snes9x, Genesis Plus GX, FBNeo, Beetle Saturn and VICE retain
-native rendering, scaled by RetroArch for the display. MAME uses its 4K target
-for vector games and native rendering for raster games. Renderer, JIT, filtering
-and accuracy options are unchanged. Higher resolutions remain selectable per
-game. RPCS3's separate source-only profile is unchanged.
+Use matching arcade sets: MAME currently targets **0.289**, and FBNeo requires
+sets compatible with its pinned version. Azahar requires decrypted content.
+Core binaries must be built for this native SDK and loader; desktop cores or
+cores from another PS5 distribution are not interchangeable.
-Saved core, content-directory and game options take precedence over these
-new defaults. On an existing install, use **Quick Menu → Core Options → Manage
-Core Options → Reset Core Options**, then save the appropriate core/game options
-and **Close Content**, then reload. Reset Core Options resets all options for that
-core; to keep other custom settings, change only the resolution and MSAA entries
-listed above and save them instead. An existing game or directory override must
-also be updated if it supplies those values.
+RPCS3 is **source-only and excluded from every release**. Its separate build
+instructions and distribution restrictions are below. It is also excluded from
+the WebUI’s guided core catalogs.
-**God of War: Chains of Olympus (PPSSPP):** a user on firmware 5.02 reported an
-intro crash at 10× and working play at 6×. Their logs show 10× geometry, 8× MSAA
-pipelines and a null-pointer fault. The default now uses 6× with 8× MSAA, selected after the console
-save-state checks below; turning MSAA off leaves additional memory headroom.
+## Balanced graphics for a 4K display
-The **Ghost of Sparta** save-state reproduction now reports the actual failure:
-Vulkan runs out of device memory at 10× with 8× MSAA. The new build checks image
-and view creation, reclaims retired GPU allocations and retries once. On the
-console, the first load recovered; an unrecoverable allocation after the second
-load closed content and returned to the frontend without the old null-image
-fault. This makes memory exhaustion recoverable; it does not make 10×/8× a
-recommended configuration.
+RetroArch presents at the display resolution. Internal rendering is chosen to
+leave room for emulation and memory use; it need not reach native 4K. Saved
+core, folder and game options take priority over these compiled defaults.
-The same state passed three loads and one save/load round trip at both 6× with
-MSAA off and 6× with 8× MSAA, each in an 80-second run with normal exit.
-The owner-selected default is now 6× with 8× MSAA; MSAA off remains a
-lower-cost option for demanding games. These tests
-cover one affected state, not every game, the original reporter's firmware 5.02
-console, or a long soak. See the [memory recovery test record](evidence/ppsspp-memory-recovery/).
-
-| Core | Systems covered by the core | Console verification in this port |
+| Core | Default internal resolution | Anti-aliasing |
| --- | --- | --- |
-| [FCEUmm](https://github.com/libretro/libretro-fceumm) | NES / Famicom | ✅ Gameplay, audio and input; subsequent shared menu-transition fixes verified. [Evidence](evidence/native-core-loading/) |
-| [mGBA](https://github.com/libretro/mgba) | Game Boy, Game Boy Color, Game Boy Advance | ✅ GB/GBC/GBA loading, corrected colours and clean menu/next-game transitions. [Evidence](evidence/mgba-native/) |
-| [Snes9x](https://github.com/libretro/snes9x) | SNES / Super Famicom | ✅ Tested gameplay, colours, audio/input and menu transitions; not every special chip or video mode. [Evidence](evidence/snes9x-native/) |
-| [FinalBurn Neo](https://github.com/libretro/FBNeo) | Supported arcade boards, including Neo Geo and Sega System 16/32 | ✅ Tested arcade games using both native 32-bit and converted 16-bit output; not every board or ROM set. [Evidence](evidence/fbneo-native/) |
-| [Genesis Plus GX](https://github.com/libretro/Genesis-Plus-GX) | Mega Drive / Genesis, Master System, Game Gear, SG-1000, Sega CD | ✅ Genesis gameplay and clean transitions, which I confirmed on the console. Other Sega systems and disc/BIOS paths still need separate acceptance. [Evidence](evidence/genesis-plus-gx-native/) |
-| [PPSSPP](https://github.com/hrydgard/ppsspp) v1.20.4 | PlayStation Portable | ✅ Tested games at 10× internal resolution (4800×2720), 16× anisotropy: correct picture, full speed at 120 Hz, save states, fast-forward, and closing and reopening games. MSAA renders on RADV (it needs render pass 2, which ps5vk lacked). |
-| [Dolphin](https://github.com/libretro/dolphin) 2609 | GameCube, Wii | ✅ GameCube and Wii games tested for up to an hour of play, with the JIT and fast memory, save states and closing and reopening games. One tested game still slows to about 76–85% at some transitions (see the release notes). |
-| [LRPS2](https://github.com/libretro/LRPS2) (PCSX2) | PlayStation 2 | ✅ Tested games at 6× internal resolution on the Vulkan hardware renderer, full speed, with multi-threaded VU1 and save states. Needs your own BIOS in `system/pcsx2/bios/`. |
-| [Beetle PSX HW](https://github.com/libretro/beetle-psx-libretro) | PlayStation | ✅ 16× internal resolution on the Vulkan renderer, 32-bit colour, PGXP (no wobbling polygons), full speed, and closing and reopening the game. The disc image is read into memory at load. It runs with its built-in OpenBIOS; your own BIOS (`scph5501.bin` and the others its metadata lists) in `system/` is used when present. |
-| [Mupen64Plus-Next](https://github.com/libretro/mupen64plus-libretro-nx) | Nintendo 64 | ✅ ParaLLEl-RDP at 4× upscaling (the default since v0.5.6-alpha.5; 8× stays an option) and ParaLLEl-RSP, both JITs on: 59.9 fps with clean audio in the tested game, and closing and reopening it. A new upscaling factor takes effect when the game is started again (Close Content, then load it). |
-| [Beetle Saturn](https://github.com/libretro/beetle-saturn-libretro) | Sega Saturn | ⚠️ Loads, then needs your own BIOS in `system/`: `mpr-17933.bin` (US/EU) or `sega_101.bin` (JP). Without it the game refuses to load and the menu stays usable. Gameplay not yet tested. |
-| [VICE](https://github.com/libretro/vice-libretro) x64sc | Commodore 64 | ✅ A `.d64` disk game at full speed, and closing and reopening it. |
-| [MAME](https://github.com/libretro/mame) 0.289 | Arcade | ✅ A tested game from a 0.289 non-merged set, BIOS in the same folder: full speed, and closing and reopening it. Raster games render at their native size and are scaled on the GPU. Vector games are drawn at 4K by MAME's alternate renderer (not yet tested on the console). Sets must match 0.289. |
-| [DeSmuME](https://github.com/libretro/desmume) | Nintendo DS | ✅ 5× (1280×960) with the JIT and eight rasterizer threads, full speed, and closing and reopening the game. 6× measured 93–95%. |
-| [Azahar](https://github.com/azahar-emu/azahar) | Nintendo 3DS | ✅ 18× internal resolution (the most Azahar offers) on Vulkan, with asynchronous shader compilation and the JIT, full speed after boot, and closing and reopening the game. Decrypted games only. |
-| [RPCS3](https://github.com/mihawk-99/PS5_RPCS3) (my fork) | PlayStation 3 | ⚠️ **Not in any release: build it yourself from source** ([how](#playstation-3-rpcs3-build-it-yourself); its licence, see [License and third-party terms](#license-and-third-party-terms)). On my console build: 4K at 60 fps in gameplay in one tested game, and 4K held at 30 fps in another (a game with only an "Unlock FPS" patch runs it with RPCS3's frame limit at 30 by default, the "Frame-rate patches" option), steady where the emulation keeps up, with its busiest scenes still at 24–27 fps. Needs your own PS3 system software (`PS3UPDAT.PUP` in `system/RPCS3/`) and your own games; a PSN purchase installs with its `.rap` licence file. |
+| PPSSPP | 6× · 2880 × 1632 | 8× MSAA |
+| Dolphin | 4× | No MSAA |
+| LRPS2 | 4× · approximately 1440p | Core default |
+| Beetle PSX HW | 8× | MSAA off |
+| Mupen64Plus-Next | 4× | Core default |
+| Azahar | 6× · 2400 × 1440 top screen | Core default |
+| DeSmuME | 4× · 1024 × 768 per screen | Core default |
-None of the games I tested with is provided.
-**Use only legally obtained backups of games you own**, and BIOS files dumped
-from your own hardware: piracy is not condoned.
+Other cores retain native rendering, scaled for the display. MAME uses a 4K
+target for vector output; that path still needs console acceptance.
-Use **FBNeo for Sega System 16/32 arcade sets**, rather than Genesis Plus GX.
-FBNeo needs compatible arcade sets and receives its ZIP/7z archives intact.
-Archive support and BIOS requirements vary by core.
+PPSSPP’s **6× / 8× MSAA** default passed the recorded save/load checks. At
+10× / 8× MSAA, the tested workload exhausted device memory. Failed framebuffer
+allocations are now cleaned up and retried once; an unrecoverable failure returns
+to the menu instead of using a missing image. This improves recovery, not the
+amount of memory available. Disabling MSAA leaves more headroom.
-Core binaries must be built for **this native pipeline and SDK**. A desktop `.so`
-or a core from a different PS5 RetroArch distribution is not automatically
-compatible. No games or BIOS files are bundled.
+To adopt these defaults on an existing installation, change the listed options
+in the WebUI or **Quick Menu → Core Options**. Reset Core Options resets every
+option for that core, so use individual controls if you want to keep other choices.
-## Graphics and native runtime
+## Your files
-```text
-Software core → video callback → RetroArch Vulkan video driver
- → RADV, linked into the title → PS5 display
-XMB / RGUI ──────────────────────┘
-Hardware cores (PPSSPP, Dolphin, LRPS2, Beetle PSX HW,
-Mupen64Plus-Next, Azahar) → Vulkan through RetroArch's HW context → RADV
-```
+`/app0` is the running title’s mount. Over FTP, use your installed title folder,
+usually `/data/homebrew/PPSA99169/`.
-[PS5_Vulkan](https://github.com/mihawk-99/PS5_Vulkan), which I also maintain,
-is the separate GPU-driver project used here. Since v0.5.0-alpha.5 the title
-links its port of RADV: Mesa's Vulkan driver and ACO compiler, unchanged but
-where the console differs, over a PS5 winsys, built from my Mesa fork
-[PS5_Mesa](https://github.com/mihawk-99/PS5_Mesa); v0.5.6-alpha.5 links its
-revision `0b2d6d1`. It reports Vulkan 1.4, and its conformance is that
-project's milestone: the full Khronos CTS runs on the console, and its second
-full run ended with no failure. Up to v0.4.0-alpha.4 the title linked ps5vk, the project's first
-driver, which `PS5_VULKAN_DRIVER=ps5vk` still builds.
-
-The driver is **linked into the title**. Updating a driver checkout does not
-update the linked code: rebuild and redeploy the RetroArch title against the
-intended driver artifacts. A `libvulkan.so.1` left in the title folder by an
-earlier release is ps5vk's and is not used.
-
-This repository supplies the frontend/platform integration, native audio and
-input backends, core loader, build scripts and console validation. Core-side
-pixel adapters preserve the renderer's buffers while matching the frontend's
-upload format. The CPU video backend remains available as a fallback; the
-current default is `video_driver = "vulkan"`, `menu_driver = "xmb"`.
-
-PPSSPP's JIT runs: its code memory is mapped read-write and then made
-executable, and its fast-memory fault handler reads the console's own signal
-context layout. The port builds PPSSPP v1.20.4 with one patch
-(`patches/ppsspp/ps5-port.patch`) and FFmpeg 3.0.2 for game videos. It starts
-with the frontend's balanced defaults (6× internal resolution, 8× MSAA),
-retaining 16× anisotropy, auto max-quality filtering, hardware transform,
-software skinning, no frameskip and no speed hacks. The core's older one-time
-profile migration still sets an existing `PPSSPP.opt` aside as
-`PPSSPP.opt.before-ps5-profile` if its v1 marker is absent; this update does not
-repeat that migration. The native loader has explicit limits, including
-no TLS or general exception-unwind registration, and it waits for a core's
-threads to finish before unmapping the core.
-
-The CPU heap and Vulkan allocations use the same console direct-memory pool.
-The heap commits memory on demand; each core does not receive a separate
-11.65 GiB allowance. SDK `f674976` replaces busy allocator waits with sleeping
-waits and exposes the pool's free space and largest contiguous block. This
-avoids consuming a CPU while another thread owns an allocator lock; it does
-not promise a particular frame-rate increase.
-
-PPSSPP uses that shared-pool snapshot to trim unused textures and temporary
-framebuffers under pressure. It keeps recent textures and guest framebuffer
-contents, waits for submitted work before reclaiming retired GPU objects, and
-retries a failed framebuffer allocation once. If image or image-view creation
-still fails, it requests a controlled content shutdown with an explanation
-instead of passing a missing image to the driver. Internal resolution and MSAA
-are not silently changed. `trace.txt` records CPU heap use, GPU allocations,
-free space, largest free block and allocation results around state loads and
-these failures; an unavailable measurement is explicitly marked unknown.
-
-## Roadmap
-
-**✅ = verified for the stated scope. ❌ = pending implementation or acceptance
-in this port, even if upstream RetroArch already offers the feature.**
-
-### Frontend and platform
-
-- ✅ Native startup and clean exit.
-- ✅ GPU presentation through PS5_Vulkan; selectable CPU fallback.
-- ✅ XMB, with RGUI retained.
-- ✅ Native input, analog menu navigation and remapping.
-- ✅ Native stereo audio and buffering diagnostics.
-- ✅ Filesystem browsing, configuration persistence and content loading.
-- ✅ Native core loading, metadata and failed-load recovery.
-- ❌ Save RAM and save-state persistence verified across restarts and core changes.
-- ❌ Core-option persistence and per-game/per-core overrides fully validated.
-- ❌ BIOS/system-file coverage, disc swapping and multi-disc acceptance tests.
-- ❌ RetroAchievements and netplay; RetroArch’s netplay and achievement networking remain disabled; the separate local WebUI service is available.
-- ❌ User Slang shader presets and multipass effects validated on PS5_Vulkan.
-- ✅ 120 Hz output where the display offers it, with a 60 Hz fallback chosen by measuring the refresh.
-- ❌ No core losing speed while a shader compiles. On RADV (Alpha 5), PPSSPP's compiles on its own threads no longer cost it speed, and a game's second start reads its pipelines from the cache; Dolphin's first start of a game still compiles its ubershaders at a cost (see the release notes).
-- ✅ Save states and fast-forward, including PPSSPP.
-- ❌ 4K output/upscaling, VRR and HDR validated in this application.
-- ❌ Low-latency features, runahead and sustained per-core performance measurements.
-- ❌ Broader compatibility testing and release qualification.
-
-### Cores
-
-| Status | Core / milestone |
+| Folder or file | Purpose |
| --- | --- |
-| ✅ | FCEUmm — NES |
-| ✅ | mGBA — GB / GBC / GBA |
-| ✅ | Snes9x — SNES |
-| ✅ | FBNeo — tested arcade games |
-| ✅ | Genesis Plus GX — tested Genesis gameplay |
-| ❌ | Beetle PCE — PC Engine / TurboGrafx-16, SuperGrafx and CD; next proposed addition |
-| ❌ | Stella — Atari 2600; candidate |
-| ❌ | PicoDrive — add Sega 32X coverage; candidate |
-| ✅ | MAME 0.289 — arcade; tested games only |
-| ✅ | Beetle PSX HW — PlayStation, Vulkan renderer at 16× |
-| ✅ | Mupen64Plus-Next — Nintendo 64, ParaLLEl-RDP at 4× (8× selectable) |
-| 🚧 | Beetle Saturn — Sega Saturn; needs a gameplay test with a BIOS |
-| ✅ | VICE x64sc — Commodore 64 |
-| ✅ | DeSmuME — Nintendo DS at 5× |
-| ✅ | Azahar — Nintendo 3DS, Vulkan at 18× |
-| ❌ | EXTERNAL storage (USB, extended storage) readable from inside the title's sandbox |
-| ✅ | PPSSPP — PSP, Vulkan rendering and JIT; tested games only |
-| ✅ | PPSSPP MSAA — render pass 2 and depth/stencil resolve, on RADV |
-| ✅ | Dolphin — GameCube and Wii, Vulkan rendering and JIT; tested games, long play and the enhancement profiles |
-| ✅ | LRPS2 — PlayStation 2, Vulkan hardware renderer at 4K; tested games only |
-| 🚧 | LRPS2 — upstream PCSX2's newer renderer fixes, 8× internal resolution and texture replacement |
-| 🚧 | RPCS3 — PlayStation 3 at 4K; source only, never in a release (build it yourself); the busiest scenes of a 30 fps game still below 30 |
+| `content/` | Your content; available to WebUI uploads and downloads |
+| `content/Saturn/` | Saturn disc images; created automatically |
+| `system/` | General BIOS and system data |
+| `system/Saturn/` | Saturn BIOS files; created automatically |
+| `system/pcsx2/bios/` | PlayStation 2 BIOS |
+| `system/fbneo/` | FinalBurn Neo system files |
+| `cores/` and `info/` | Native cores and their metadata |
+| `config/retroarch.cfg` | Live RetroArch configuration |
+| `config/webui.cfg` | Saved global WebUI preferences |
+| `config//` | Core options and RetroArch overrides |
+| `savefiles/` and `savestates/` | Save RAM and save states |
+| `radv-shader-cache/` | Reusable compiled graphics pipelines |
-Future entries are development targets, not a promised release order. Hardware
-rendering introduces new Vulkan requirements beyond presenting software frames;
-PPSSPP was the first core to exercise them, and six cores do now.
+**Saturn setup:** place `mpr-17933.bin` (US/Europe) or `sega_101.bin` (Japan)
+in `system/Saturn/`. Keep a disc’s `.cue` and all referenced tracks together,
+then load the `.cue`. The default system path is routed to the Saturn folder;
+an explicitly selected custom system directory remains unchanged.
+
+Genesis Plus GX’s Sega CD BIOS files and Beetle PSX HW’s optional BIOS files
+belong in the general system folder, with the filenames listed by their metadata.
+BIOS uploads use FTP; the WebUI only exposes `content/`.
+
+Ordinary scripted updates preserve content and saved settings. Back up your
+files before replacing or removing a title. The file browser has **INTERNAL**
+for the title folder and **EXTERNAL** for `/mnt`; the current title sandbox hides
+external mounts, so EXTERNAL may be empty.
+
+## What has been verified
+
+Saturn now loads its BIOS from `system/Saturn/`. Console testing reached
+controlled gameplay with clean rendering and a normal exit. The fixes cover
+executable memory for its JITs and ownership of cropped video frames. This is
+a short gameplay check, not a full compatibility or long-session guarantee.
+
+Native startup and exit, Vulkan presentation, controller input, stereo audio,
+configuration persistence and representative core loading have console evidence.
+Save-state and memory-pressure results cover the recorded workloads, not every
+core or firmware. Controller rumble uses synthesized DualSense haptics with an
+ordinary-rumble fallback; physical feel still awaits owner confirmation.
+
+The title uses [PS5_Vulkan](https://github.com/mihawk-99/PS5_Vulkan)’s RADV port.
+CPU and GPU allocations share the console’s direct-memory pool; each core does
+not receive a separate 11.65 GiB allowance. A selectable CPU video backend remains
+available. RetroAchievements and netplay remain disabled. Broader BIOS, disc
+swapping, shader-preset and long-session coverage is still in progress.
+
+[Recorded evidence](evidence/) accompanies verified changes. For a bug report,
+include the core, file format, settings and reproduction steps. Preserve
+`retroarch.log` and `trace.txt` **before reopening RetroArch**: the frontend log
+is replaced on each launch. Remove private paths, addresses and credentials
+before sharing captures.
+
+---
## Build from source
@@ -398,144 +300,10 @@ update page) in `system/RPCS3/`, where it installs on the first start, and
your own games: a disc you own, dumped yourself, or a PSN purchase with its
`.rap` licence file. Piracy is not condoned.
-## Install and file locations
-The verified deployment is a **homebrew title folder**, not a retail package.
-Copy the complete `dist/PPSA99169/` tree to the title location used by your
-configured homebrew launcher. The current validation setup uses
-`/data/homebrew/PPSA99169/`. This project does not install a jailbreak or launcher.
+
+Authors and acknowledgements
-`/app0` is the running application's mount point. Over FTP, use the corresponding
-title folder instead:
-
-| Purpose | Under `/data/homebrew/PPSA99169/` | In RetroArch |
-| --- | --- | --- |
-| Native cores | `cores/` | `/app0/cores/` |
-| Core metadata | `info/`, with compatibility copies in `cores/` | `/app0/info/` |
-| Games | `content/` | `/app0/content/` |
-| BIOS/system data | `system/` | `/app0/system/` |
-| PS2 BIOS (your own dump) | `system/pcsx2/bios/` | `/app0/system/pcsx2/bios/` |
-| PS3 system software, RPCS3's drives (your own build only) | `system/RPCS3/` | `/app0/system/RPCS3/` |
-| Live configuration | `config/retroarch.cfg` | `/app0/config/retroarch.cfg` |
-| Save RAM | `savefiles/` | `/app0/savefiles/` |
-| Save states | `savestates/` | `/app0/savestates/` |
-| RADV shader cache | `radv-shader-cache/` | `/app0/radv-shader-cache/` |
-
-RADV creates `radv-shader-cache/` itself, open to FTP like the other folders;
-deleting it only makes the next start compile again. `ps5vk-shader-cache/` and
-`sce_module/libvulkan.so.1`, left by releases up to v0.4.0-alpha.4, are not used
-since v0.5.0-alpha.5 and can be deleted.
-
-Everything you put in `content/` and `system/` must be **your own legally
-obtained backups**: games you own, and BIOS or firmware dumped from hardware you
-own. Piracy is not condoned.
-
-For FBNeo, use `system/fbneo/` for its system files. Genesis Plus GX's Sega CD BIOS
-filenames belong in the configured `system/` root, as listed by its metadata.
-
-The application creates its managed writable folders and seeds live settings
-only when no live configuration exists. Ordinary scripted updates preserve user
-content and saved settings. Existing settings can therefore keep RGUI selected
-even though XMB is the packaged default. Back up user files before any clean
-removal; `--clean` removes the entire title folder.
-
-`tools/deploy-title.py` publishes a built `dist/PPSA99169/` over FTP and reads
-every file back; console details belong in the ignored `.env`, based on
-`.env.example`.
-
-## WebUI
-
-Start RetroArch, then open **`http://:6769`** in a browser on the
-same network. The WebUI starts automatically and stops when RetroArch exits.
-It uses local HTML, CSS, JavaScript, fonts and artwork; only the GitHub release
-check needs internet access. This feature is in the source build and will be
-included in the next release.
-
-- **Overview:** release status, release notes, upload destination, recent
- transfers and quick settings. Published builds compare their tag against
- this repository’s releases, including alpha releases. Development builds
- identify themselves without claiming to be up to date. “View repository”
- opens GitHub; updates are not installed automatically.
-- **Content:** browse the title’s `content/` folder, create subfolders, upload
- files by dropping them or choosing Browse files, and download existing files.
- Uploads stream to storage, support cancellation, and refuse existing names.
- The per-file limit is 64 GiB. Free space is not reported on PS5 because its
- compatibility API does not provide a measured value.
-- **Transfers:** progress and results from the current browser session.
- Downloads are handled by the browser’s download manager.
-- **Settings:** start in **Guided** for categories, descriptions and ready-to-use
- controls. Global preferences are grouped into Video, Audio, Input, Saving,
- System and Interface. Choose a core profile for its **Core options** or
- **RetroArch overrides**; PPSSPP provides System, Video, Input, Hacks and Network.
- All 15 supported core guides (RPCS3 excluded) are available before opening a
- game, with grouped options, exact dropdown choices and explanatory help.
- Catalogs are generated from the pinned PS5 core sources and include the PS5
- defaults; saved values take priority. BIOS/cartridge lists and game-specific
- options such as arcade DIP switches are added when their core registers them.
- **Advanced** retains the full saved configuration, technical keys and exact
- value fields, with search and 40-row pages. Global settings without a guide
- remain available there. Switching categories or modes keeps unsaved edits.
- Values outside the listed choices are preserved as “Current” until changed.
- Saved changes apply the next time RetroArch starts. WebUI light/dark
- appearance applies immediately and is remembered only in that browser.
-
-Bundled catalogs live in `webui/core-metadata/`. Additional options registered
-by a running core are cached in `config/webui-metadata/`; the WebUI reads these
-snapshots without querying live emulator state. Snapshots are bound to the
-catalog and core binary, so an upgrade cannot reuse obsolete choices or defaults.
-The build-time generator uses a host C++ compiler to serialize option tables,
-without loading an emulator or executing a game.
-
-Browser changes are saved separately in `config/webui.cfg`; explicitly supplied
-launch overrides take precedence. Core edits wait in `config/webui-cores/`
-until startup, then merge into the core’s own `.opt` or `.cfg` and are consumed.
-This prevents a running core from overwriting pending browser edits, while
-allowing later changes made on the console to persist normally. Core RetroArch
-overrides require automatic overrides to be enabled; game and folder overrides
-can take priority. Stale browser saves are rejected until refreshed. Uploads
-are confined to `content/`, and the
-service does not expose arbitrary console paths. This is a local-network HTTP
-service without a login: use it on a trusted network and do not forward port
-6769 to the internet.
-
-The purple layout uses a fixed desktop text scale and a bounded content width,
-so ultrawide screens do not enlarge every control. The discreet creator portrait
-is included locally.
-The HTTP transport uses GNU libmicrohttpd, following
-[ps5-payload-dev/websrv](https://github.com/ps5-payload-dev/websrv).
-
-## Testing and troubleshooting
-
-A successful build proves neither gameplay nor correct rendering. Core acceptance
-includes native loading, gameplay, colour checks, audio/input, Quick Menu →
-Close Content, and loading another game. I record my own visual confirmation on
-the console alongside the logs; a camera can miss refresh-synchronous flicker.
-
-Before each release every core in it runs its game on the console: boot, the
-menu opened and closed twice, Close Content and a reload, with its frame rate,
-audio and a screenshot checked before and after. The release notes give the
-results; they are the tested games, not a core's upstream feature list.
-
-For reports, include the core, game-file format, relevant settings, reproduction
-steps and whether the application was closed manually. Preserve `retroarch.log`
-and `trace.txt` before reopening: the frontend log is replaced on a new launch.
-The test tools retain kernel captures in ignored `klog/`. Redact private paths,
-console addresses and credentials before sharing logs.
-
-Old `gpu-buffers-*.bin`, `gpu-stages-*.bin` and `gpu-tables-*.bin` files are temporary
-rendering diagnostics from earlier investigations. They are not required runtime
-assets and can be removed. Keep the normal development logs when reporting bugs.
-
-## Documentation
-
-Each release's notes on the
-[Releases page](https://github.com/mihawk-99/PS5_RetroArch/releases) are the
-public record of what changed, what was tested and what is known not to work.
-The committed [evidence](evidence/) holds machine-readable captures and their
-expected results. My design notes, logs and procedures are kept locally and are
-not published.
-
-## Authors and acknowledgements
This port builds on substantial upstream and PS5 homebrew work. Credits below
identify project authors and teams; their repositories retain the full contributor
@@ -578,6 +346,9 @@ lists and original notices.
| [RPCS3](https://github.com/RPCS3/rpcs3) | RPCS3 Team and contributors |
| [libretro core-info](https://github.com/libretro/libretro-core-info) | Metadata maintainers and contributors |
+
+
+
## License and third-party terms
This repository's own code is **GPL-3.0-or-later** ([LICENSE](LICENSE)). Most source
@@ -625,3 +396,5 @@ and PS5 are Sony trademarks. Vulkan is a registered trademark of the Khronos Gro
Inc.; the RADV port this title uses is not a Khronos-conformant product (see
[PS5_Vulkan](https://github.com/mihawk-99/PS5_Vulkan)). RetroArch is the libretro
project's name and logo, used here to name the frontend this port is built from.
+
+made by Mihawk · Built on the work of the RetroArch, libretro and PS5 homebrew communities.
diff --git a/assets/readme/webui-overview.png b/assets/readme/webui-overview.png
new file mode 100644
index 0000000000000000000000000000000000000000..f23654b4352b5c397e7eb8b02b4d2dfde8899717
GIT binary patch
literal 130145
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