mirror of
https://github.com/knutwurst/patchdl.git
synced 2026-10-06 08:00:21 +02:00
Knutwurst
0510e3dc34
Full GPL-3.0 text in LICENSE, SPDX-License-Identifier header on every
source file, README license section updated. Copyright (C) 2026 Knutwurst.
Tidied a couple of stale comments in patchdl_tile.{c,h} while at it.
102 lines
3.5 KiB
Markdown
102 lines
3.5 KiB
Markdown
# 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/tile-homescreen.jpg" alt="PatchDL on the PS5 home screen" width="720">
|
||
</p>
|
||
|
||
## What it does
|
||
|
||
- Lists every game installed on your console and looks up the newest update
|
||
Sony has published for it.
|
||
- Compares the available patch against your firmware and only offers updates
|
||
that will actually run on the system you have.
|
||
- Downloads the update package into internal storage and installs it
|
||
on-console — same end result as a normal system update, with you in control
|
||
of when and what.
|
||
- Pauses, resumes, and survives reboots: a 60 GB patch can be picked up where
|
||
it left off after a power-cycle.
|
||
|
||
## 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** is selected by default — games with an installable update.
|
||
- **Updating** is the queue: jobs waiting for a free slot.
|
||
- **Up to date**, **Needs FW**, **Can't update** — the rest.
|
||
- **All** is the flat list, top-right corner.
|
||
|
||
**Update all** in the top bar queues everything that's installable 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 — nothing needs a reboot.
|
||
|
||
- **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/tv-browser.jpg" alt="The PatchDL UI in the on-console browser" width="820">
|
||
</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 is released under the **GNU General Public License v3.0 or later**.
|
||
See [LICENSE](LICENSE) for the full text. In short: you're free to use, study,
|
||
modify and share it — and any fork or derivative work has to stay under the
|
||
same license.
|
||
|
||
Copyright © 2026 Knutwurst.
|