# PatchDL

A self-contained patch downloader and installer for the PS5, with its own
dark-mode web UI. Drop it on the console, open the URL on any device on the
same network, pick the games you want patched.

<p align="center">
  <img src="docs/images/tv-browser.jpg" alt="The PatchDL UI in the on-console browser" width="820">
</p>

## What it does

- Lists every installed game on your console and looks up Sony's newest patch
  for it.
- Checks each patch against your firmware and offers only the ones your
  console can run.
- Downloads the update into internal storage and installs it on the console.
  Same end result as a system update, on your schedule, with the patches you
  pick.
- Pauses, resumes, survives reboots: a 60 GB patch picks back up where it
  stopped after a power cut.

## The web UI

Open `http://<console-ip>:12880/` in any browser on the network. The UI works
full-screen in the on-console browser, in any desktop browser, and on phone.

<p align="center">
  <img src="docs/images/ui-desktop.jpg" alt="PatchDL Games view in a desktop browser" width="1100">
</p>

The Games view groups everything you have installed into filter chips:

- **Updatable**, selected by default: games with an installable update.
- **Updating**: jobs waiting for a free slot in the queue.
- **Up to date**, **Needs FW**, **Can't update**: the rest.
- **All**: the flat list, top-right corner.

**Update all** in the top bar queues every installable update in one click.
A live banner above the games list shows the current title, its download
speed, ETA, and a `3 of 9`-style position when more than one update is
running through the queue.

## Settings

<p align="center">
  <img src="docs/images/ui-mobile-settings.jpg" alt="PatchDL Settings view on phone" width="380">
</p>

Settings persist across restarts and apply live. No reboot needed.

- **Default policy** to allow or deny new titles by default, with a per-game
  override.
- **Install after download** so a finished update applies itself.
- **Delete the package after install** to reclaim the disk space.
- **Verify downloaded pieces** with a checksum while transferring.
- **Home-screen shortcut** that drops a PatchDL tile on the PS5 home menu;
  tapping the tile opens the web UI in the on-console browser.
- **Parallel download connections** (1–16), tunable on the fly.

## Home-screen tile

Toggle the shortcut on and PatchDL registers itself as a regular app on the
PS5 home screen. Tap the tile and the on-console browser opens straight on
the games list.

<p align="center">
  <img src="docs/images/tile-homescreen.jpg" alt="PatchDL tile on the PS5 home screen" width="720">
</p>

## Build

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

Needs the `ps5-payload-dev` SDK and the prebuilt `libcurl` + `OpenSSL` from
its `pacbrew-repo`. `libmicrohttpd` is vendored, SQLite too.

## Deploy

`scripts/deploy_ps5.sh` uploads the build, replaces any running instance,
and launches the new one. On launch you get an on-screen notification with
the exact URL to open.

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

<p align="center">
  <img src="docs/images/startup-toast.jpg" alt="On-screen notification with the web UI URL" width="640">
</p>

## License

PatchDL ships under the **GNU General Public License v3.0 or later**. See
[LICENSE](LICENSE) for the full text. Short version: use, study, modify,
share. Forks stay under the same license.

Copyright © 2026 Knutwurst.