A simple HTTP server for self hosting PS4 & PS5 packages. Pulls metadata out of each package for easy content identification regardless of file name. Transparently serves split packages as one contiguous pkg. Identifies fpkg updates not married to the base game. Supports pushing directly to consoles running MangoScango/ps5-ezremote-dpi or similar services.
See docker-compose.yml for Docker deployment. To run on bare metal:
set PKG_DIRS=D:\PS4\pkgs
py -m pip install -r requirements.txt
py -m uvicorn app:app --host 0.0.0.0 --port 8000
Then open http://localhost:8000.
| Variable | Purpose | Default |
|---|---|---|
PKG_LIBRARY |
Host path to your PKG library (mounted read-only at /pkgs) |
./pkgs |
PKG_DIRS |
Colon-separated dirs to scan inside the container | /pkgs |
SCAN_WORKERS |
Parallel parse workers | 8 |
PUBLIC_HOST |
Force the host:port the console downloads from |
auto-detect |
ENTITLEMENTS_CSV |
Entitlement catalogue for cloud install | entitlements_all.csv |
CONSOLE_SUBNET |
Subnet swept for consoles when the startup broadcast finds none, e.g. 192.168.1.0/24 (max 1024 addresses). off disables discovery |
the host's own /24 when not in a container |
CONSOLES_FILE |
Where discovered consoles are saved | consoles.json next to the icon cache |
- Icons and other runtime data persist in
./data(mounted at/data). - Add more libraries by adding
:rovolumes indocker-compose.ymland listing them all inPKG_DIRS(e.g./pkgs:/pkgs2).
You can push retail titles directly from the CDN to your console by clicking the cloud icon in the header. You can search through your PSN entitlements by contributing your entitlements database to Garlic Saves. Afterwards, just export and upload the entitlements_all.csv to the server or drop it in the scripts working directory. You can also paste a direct .pkg, .json manifest, or version.xml URL into the search box to install from it directly. Updates from OrbisPatches will work automatically, just paste the link for any pkg piece and the server will push the full update. For PS5, use the SC pkg link provided by ProsperoPatches. When pushing from the CDN, you can additionally proxy the content through the server to bypass any DNS blocks on console. The server will prefetch content as the console moves through the download, so this can actually improve your download speed if you find PSN typically does not saturate your connection.
OpenOrbis/LibOrbisPkg for PS4 Pkg Format Reference
hippie68/msum for PS4 Update Pkg Marriage Checksum
SvenGDK/LibProsperoPKG for PS5 Pkg Format Reference