Knutwurst 3f40dc1d7c Rework the web UI: tile-based progress, view nav, responsive
Replace the single-page layout with a view-based one (Games / Settings /
Logs via the left nav) and fold all download UI into the game tile — the
separate download queue is gone.

Per tile while downloading: an in-tile progress bar with auto-scaled size
(B/KB/MB/GB/TB), live transfer speed and ETA from the poll deltas, and a
green "Downloading" marker. One fixed-width action button that no longer
reflows with its label: a blue Update/Download/Install that morphs into an
amber Cancel while the download runs, plus a ghost Delete for a finished
package.

Settings and Logs moved to their own pages. Mobile-first responsive layout
(rail collapses to a top bar, icon-only nav, single-column tiles, >=44px
touch targets, 16px inputs). Real free space (statvfs) is shown auto-scaled
in the rail and status strip.

New "Home-screen shortcut" toggle (default on, persisted as home_shortcut
in config.json). The actual PS5 tile install is not wired yet: it needs a
prebuilt deeplinkUri stub PKG installed via sceAppInstUtil.

Fixes from an adversarial review pass:
- Reconcile in-flight downloads from /api/downloads onto the cards, so
  progress + Cancel appear after a reload or a download started elsewhere,
  and stop the per-poll full-grid rebuild.
- Clear the downloaded flag on install and once the server reports the
  title up to date, so a patched title no longer shows Install/Delete
  forever.
- Zero a stale speed/ETA if the byte counter goes backwards.
- a11y: nav buttons keep an accessible name when the label is hidden on
  small screens; visible focus ring on the search box; filter group is
  role=group with aria-pressed; drop the noisy grid-level aria-live; fold
  the transient "checking" state into a visible filter bucket.
2026-06-23 21:48:54 +02:00

PatchDL

A standalone PlayStation 5 ELF payload that downloads and installs official game patches on your terms. It serves its own web UI and runs without etaHEN.

PatchDL is built for setups where nanoDNS blocks Sony's servers for the whole console. It resolves the Sony patch CDN on its own path, so the rest of the system stays offline and only the patches you pick get fetched.

by Knutwurst

What it does

  • Scans installed titles and classifies each one: genuine install, ShadowMountPlus mount, preinstall, or unknown.
  • Reads the title name, installed version, and the Sony version.xml URL from the PS5 app database.
  • Fetches each title's version.xml from Sony's CDN past nanoDNS (a raw DNS query to 1.1.1.1) and verifies TLS against the pinned SCEI DNAS root.
  • Picks the newest patch compatible with the current firmware (system_ver <= firmware), so an update never forces a firmware upgrade.
  • Downloads the installable package from Sony's manifest pieces and installs it through Sony's AppInstUtil service.

Safety model

Deny-by-default. A patch is installed only for a genuine install, and only when the patch metadata targets the installed game:

Source Check Download Install
official yes yes yes
shadowmount yes yes no
preinstall / unknown yes no no

Two independent guards stop the wrong target being installed: the patch target id (read from version.xml / manifest_url) must match the installed game, and the install call receives the installed game's content id from app.db. Sony may store the actual patch bytes under a regional/master title id that differs from the target; that storage id is accepted only when version.xml targets the installed title. A true target-title mismatch is refused instead of installed as a phantom title.

For PS5 titles, delta_url often points to a small *-DP.pkg helper package. That bootstrap can make the system fetch the full patch, but it follows the package's storage/master title id and can create a duplicate/ghost title for cross-region updates. PatchDL therefore prefers the Sony manifest_url, downloads every listed pieces[] entry in order, and concatenates them into one local .pkg before handing it to AppInstUtil. The delta_url title id is kept only as the storage/master-id diagnostic.

Build

Requires ps5-payload-dev/sdk. The network and install features also need the prebuilt libcurl + OpenSSL from ps5-payload-dev/pacbrew-repo placed in the SDK sysroot (target/user/homebrew); scripts/build_ps5.sh enables them automatically when present. libmicrohttpd is vendored under vendor/etahen, and SQLite is vendored under vendor/sqlite.

scripts/build_ps5.sh        # produces patchdl-ps5.elf

Deploy

This console uses the BD-JB autoloader with itsPLK's Payload Manager on port 8084 (not a 9021 elfldr). scripts/deploy_ps5.sh uploads the ELF named with its version and launches it; the payload replaces any running instance itself.

PS5_HOST=<console-ip> scripts/deploy_ps5.sh

On start it shows an on-screen notification with the URL. Open the web UI at:

http://<console-ip>:12880/

Status

0.0.2, early. Title scan, source classification, version resolution, firmware-compatibility filtering, target/storage-id handling, and the local AppInstUtil HTTP stream have been verified on firmware 11.60. PatchDL now downloads PS5 update manifests as merged piece packages under /data/patchdl; large retail updates can be tens of GB. The download queue shows live progress, and each download can be cancelled (the partial file is deleted) or a finished package deleted again, from the queue or the title card. Manifest pieces are verified in offset order and against their declared size while merging. Open items: a full large-title manifest download/install still needs an end-to-end run, the web UI marks a title "Installing…" but reads progress from the PS5's own notifications rather than a percentage, and disc-based games need the disc inserted for their patch to apply (a normal Sony requirement). Settings (global policy and the per-game toggle) persist to /data/patchdl/config.json and survive a restart.

2026-10-05 21:26:11 +02:00
Languages
C 75.5%
JavaScript 13%
CSS 5.8%
HTML 3.4%
Shell 1.3%
Other 1%