diff --git a/README.md b/README.md index 2f39041..867b448 100644 --- a/README.md +++ b/README.md @@ -35,6 +35,16 @@ A native RetroArch homebrew title for jailbroken PlayStation 5 consoles, made by > [!WARNING] > **Designed around ShadowMountPlus 1.7beta4 or later.** Use [ShadowMountPlus 1.7beta4](https://github.com/drakmor/ShadowMountPlus/releases/tag/1.7beta4) or newer for supported USB and extended-storage access. + + +## Choose your frontend + +**RetroArch or EmulationStation.** Pick your preferred way to browse and play. + +Frontend picker offering RetroArch and EmulationStation + +Press **Square** to remember your choice. Hold **L1** during startup to return to the picker, or change it in **WebUI Settings → Start with**. + ## At a glance @@ -61,15 +71,6 @@ 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. -
-Choose your frontend - -Frontend picker offering RetroArch and EmulationStation - -Change your default later in **WebUI Settings → Start with**. - -
- ### Scan to connect | Menu | Open the WebUI QR code | @@ -94,41 +95,6 @@ Stay connected while switching between the picker, RetroArch, and EmulationStati | **Transfers** | Follow uploads and their results. Downloads appear in your browser’s download manager. | | **Settings** | Adjust global preferences, core options, controller mappings, and the startup frontend. | -### Add a game. Make it yours. - -Choose a game backup, enter details yourself or find a **LaunchBox** match, then add media. **Automatic media downloads are enabled by default**, with progress and artwork appearing as they arrive. Your own uploaded media is kept. - -### One game. Everything within reach. - -Bust-A-Move Media Inspector with compact artwork thumbnails and a preview - -- **Media:** browse, enlarge, or replace artwork, manuals, and videos. -- **Details:** edit the name and game information; your changes survive future downloads. -- **Files:** replace or export a game backup, import or export saves and savestates, and preview savestate screenshots when available. - -Close the game and back up your progress before replacing files. Savestates need the same game and a compatible core. - -### Fill in the missing artwork - -Choose **libretro**, **ScreenScraper**, and **LaunchBox**, set their order, and pick your region and language. Review uncertain matches and resume interrupted downloads. Downloads continue on your PS5 after the browser closes. - -ScreenScraper requires an account. Media availability varies by game and source; EmuMovies support is coming later. - -
-Settings, updates, and connection details - -Guided settings cover the original **15 cores**; newer cores do not yet have guided profiles. Advanced settings remain available. Save settings, then restart RetroArch when prompted. Game or folder overrides may take priority. - -**Update RetroArch** downloads and verifies a release before offering **Install and close RetroArch**. Save your progress first, then reopen the title after installation. Content, saves, settings, and existing custom BIOS/effect files are preserved. Keep room for the ZIP and extracted files, and back up before updating. Failed installs attempt to restore the previous files; a power loss may require a manual reinstall. - -**Alerts** lists missing required BIOS/system files and their configured locations. Choose **Recheck** after adding files. Checks verify presence, not authenticity; regional requirements may vary. - -The interface and artwork are served locally. Media downloads, release checks, and updates need internet access. Content uploads support files up to **64 GiB** and do not overwrite existing filenames. Available storage is not reported. - -The persistent WebUI uses an ELF loader on port **9021** or a homebrew launcher on port **8080**. Its own address is `http://:6769`. - -
- > The WebUI is a local HTTP service without a login. Use a trusted network and > do not forward port **6769** to the internet. @@ -138,41 +104,43 @@ The persistent WebUI uses an ELF loader on port **9021** or a homebrew launcher **33 native cores**, grouped below by family. Compatibility and performance vary by game. -| Family | Systems | Core | -| --- | --- | --- | -| **Nintendo** | **NES / Famicom** | FCEUmm | -| | **Game Boy**
**Game Boy Color**
**Game Boy Advance** | mGBA | -| | **SNES / Super Famicom** | Snes9x | -| | **Nintendo 64** | Mupen64Plus-Next | -| | **GameCube**
**Wii** | Dolphin | -| | **Nintendo DS** | DeSmuME | -| | **Nintendo 3DS** | Azahar | -| | **Virtual Boy** | Beetle VB | -| | **Pokémon Mini** | PokeMini | -| **Sony** | **PlayStation** | Beetle PSX HW | -| | **PlayStation 2** | LRPS2 | -| | **PlayStation Portable** | PPSSPP | -| **Sega** | **Mega Drive / Genesis**
**Master System**
**Game Gear**
**SG-1000**
**Sega CD** | Genesis Plus GX | -| | **Sega 32X** | PicoDrive | -| | **Sega Saturn** | Beetle Saturn | -| | **Dreamcast**
**NAOMI / NAOMI 2**
**Atomiswave** | Flycast | -| **Arcade & SNK** | **Arcade**
**Neo Geo** | FinalBurn Neo | -| | **Arcade** | MAME | -| | **Neo Geo Pocket / Color** | Beetle NeoPop | -| | **Neo Geo CD** | NeoCD | -| **NEC** | **PC Engine / TurboGrafx-16 / CD**
**SuperGrafx** | Beetle PCE | -| | **PC-FX** | Beetle PC-FX | -| **Atari** | **Atari 2600** | Stella | -| | **Atari 5200** | a5200 | -| | **Atari 7800** | ProSystem | -| | **Atari Lynx** | Handy | -| | **Atari Jaguar** | Virtual Jaguar | -| **Computers & adventures** | **Commodore 64** | VICE x64sc | -| | **Commodore Amiga** | PUAE | -| | **MS-DOS** | DOSBox Pure | -| | **Point-and-click adventures** | ScummVM | -| **More consoles** | **3DO** | Opera | -| | **WonderSwan / Color** | Beetle Cygne | +**Vulkan (GPU)** cores render on the GPU. **Software** cores render on the CPU, with Vulkan displaying the result. + +| Family | Systems | Core | Renderer | +| --- | --- | --- | --- | +| **Nintendo** | **NES / Famicom** | FCEUmm | Software | +| | **Game Boy**
**Game Boy Color**
**Game Boy Advance** | mGBA | Software | +| | **SNES / Super Famicom** | Snes9x | Software | +| | **Nintendo 64** | Mupen64Plus-Next | Vulkan (GPU) | +| | **GameCube**
**Wii** | Dolphin | Vulkan (GPU) | +| | **Nintendo DS** | DeSmuME | Software | +| | **Nintendo 3DS** | Azahar | Vulkan (GPU) | +| | **Virtual Boy** | Beetle VB | Software | +| | **Pokémon Mini** | PokeMini | Software | +| **Sony** | **PlayStation** | Beetle PSX HW | Vulkan (GPU) | +| | **PlayStation 2** | LRPS2 | Vulkan (GPU) | +| | **PlayStation Portable** | PPSSPP | Vulkan (GPU) | +| **Sega** | **Mega Drive / Genesis**
**Master System**
**Game Gear**
**SG-1000**
**Sega CD** | Genesis Plus GX | Software | +| | **Sega 32X** | PicoDrive | Software | +| | **Sega Saturn** | Beetle Saturn | Software | +| | **Dreamcast**
**NAOMI / NAOMI 2**
**Atomiswave** | Flycast | Vulkan (GPU) | +| **Arcade & SNK** | **Arcade**
**Neo Geo** | FinalBurn Neo | Software | +| | **Arcade** | MAME | Software | +| | **Neo Geo Pocket / Color** | Beetle NeoPop | Software | +| | **Neo Geo CD** | NeoCD | Software | +| **NEC** | **PC Engine / TurboGrafx-16 / CD**
**SuperGrafx** | Beetle PCE | Software | +| | **PC-FX** | Beetle PC-FX | Software | +| **Atari** | **Atari 2600** | Stella | Software | +| | **Atari 5200** | a5200 | Software | +| | **Atari 7800** | ProSystem | Software | +| | **Atari Lynx** | Handy | Software | +| | **Atari Jaguar** | Virtual Jaguar | Software | +| **Computers & adventures** | **Commodore 64** | VICE x64sc | Software | +| | **Commodore Amiga** | PUAE | Software | +| | **MS-DOS** | DOSBox Pure | Software | +| | **Point-and-click adventures** | ScummVM | Software | +| **More consoles** | **3DO** | Opera | Software | +| | **WonderSwan / Color** | Beetle Cygne | Software | PicoDrive also supports Mega Drive, Mega-CD, Master System, and Pico. FinalBurn Neo includes Sega System 16/32; ScummVM supports many LucasArts, Sierra, and other adventures. diff --git a/evidence/docs-showcase-refinement/capture.json b/evidence/docs-showcase-refinement/capture.json new file mode 100644 index 0000000..25c522c --- /dev/null +++ b/evidence/docs-showcase-refinement/capture.json @@ -0,0 +1,48 @@ +{ + "step": "docs-showcase-refinement", + "command": "Source assertions and CUA preview inspection; bash tools/verify.sh format evidence", + "lines": [ + "README warning and reminders unchanged", + "Four requested README sections removed", + "Frontend picker heading and screenshot visible outside disclosures", + "All 33 renderer entries match the original core table: Vulkan GPU or software", + "Both local previews refreshed; no broken images; README has no page overflow", + "Frontend showcase precedes At a glance" + ], + "readme_sha256": "2902750b24350fa09ffe7837d7ec5e51aaa906ada5443d5575e636a583338a35", + "renderer_map": { + "FCEUmm": "Software", + "mGBA": "Software", + "Snes9x": "Software", + "Mupen64Plus-Next": "Vulkan (GPU)", + "Dolphin": "Vulkan (GPU)", + "DeSmuME": "Software", + "Azahar": "Vulkan (GPU)", + "Beetle VB": "Software", + "PokeMini": "Software", + "Beetle PSX HW": "Vulkan (GPU)", + "LRPS2": "Vulkan (GPU)", + "PPSSPP": "Vulkan (GPU)", + "Genesis Plus GX": "Software", + "PicoDrive": "Software", + "Beetle Saturn": "Software", + "Flycast": "Vulkan (GPU)", + "FinalBurn Neo": "Software", + "MAME": "Software", + "Beetle NeoPop": "Software", + "NeoCD": "Software", + "Beetle PCE": "Software", + "Beetle PC-FX": "Software", + "Stella": "Software", + "a5200": "Software", + "ProSystem": "Software", + "Handy": "Software", + "Virtual Jaguar": "Software", + "VICE x64sc": "Software", + "PUAE": "Software", + "DOSBox Pure": "Software", + "ScummVM": "Software", + "Opera": "Software", + "Beetle Cygne": "Software" + } +} diff --git a/evidence/docs-showcase-refinement/expectation.json b/evidence/docs-showcase-refinement/expectation.json new file mode 100644 index 0000000..9c3383d --- /dev/null +++ b/evidence/docs-showcase-refinement/expectation.json @@ -0,0 +1,15 @@ +{ + "step": "docs-showcase-refinement", + "must_contain": [ + "README warning and reminders unchanged", + "Four requested README sections removed", + "Frontend picker heading and screenshot visible outside disclosures", + "All 33 renderer entries match the original core table: Vulkan GPU or software", + "Both local previews refreshed; no broken images; README has no page overflow", + "Frontend showcase precedes At a glance" + ], + "must_not_contain": [ + "FAIL" + ], + "human_check": "README renderer table and expanded frontend showcase checked visually; frontend appears above highlights." +}