whatisgithub

What is ps-pkg-server?

mangoscango/ps-pkg-server — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · generalComplexity · 2/5Setup · moderate

In one sentence

A self-hosted HTTP server that identifies and serves PS4 and PS5 game package files to your own consoles.

Mindmap

mindmap
  root((PS PKG Server))
    What it does
      Self hosted PKG server
      Reads embedded metadata
      Joins split packages
      Identifies fpkg updates
    Tech stack
      Python
      Uvicorn
      Docker
    Use cases
      Serve PKG library at home
      Push to console remotely
      Manage multiple libraries
    Audience
      Home server hobbyists
      Console owners

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Host PS4 or PS5 game package files on your local network so consoles can download them by name.

USE CASE 2

Automatically identify PKG files by their embedded metadata instead of relying on file names.

USE CASE 3

Serve packages that have been split into multiple parts as a single continuous download.

USE CASE 4

Push packages directly to a console running a compatible remote installation service.

What is it built with?

PythonUvicornDocker

How does it compare?

mangoscango/ps-pkg-server0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity2/52/54/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs Docker or a Python environment, plus a folder of your own PS4/PS5 PKG files to serve.

The README does not clearly state a license for this project.

So what is it?

PS PKG Server is a simple HTTP server for self hosting PS4 and PS5 game package files, known as PKG files, so you can serve them to your own consoles over your local network. Rather than relying on file names, it reads the metadata stored inside each package to identify its contents. If a package has been split into multiple parts, the server serves it back as one continuous file, so the console sees a single download. It can also identify fpkg update files that are not tied to a specific base game package, and it supports pushing packages directly to consoles running a companion project called ps5-ezremote-dpi, or similar remote installation services. You can run the server through Docker using the included docker-compose.yml file, or run it directly on your own machine. Running it on bare metal means installing Python dependencies from a requirements file and starting it with uvicorn, a Python web server, pointing it at a folder of your PKG files with an environment variable. Once it is running, you open a web page on localhost to browse and manage the library. A handful of settings control how the server behaves. You can set which host path holds your PKG library, which directories inside the server it should scan, how many files it parses in parallel, and whether to force a specific host and port for downloads instead of letting the server detect it automatically. Icons and other data the server generates while running are saved to a separate folder so they persist between restarts. You can also add more than one PKG library by mounting extra folders and listing them together in the directory setting. The README credits three other open source projects for reference material on the PS4 and PS5 package file formats and the update marriage checksum method, which this project relies on to understand how the files are structured.

Copy-paste prompts

Prompt 1
Help me set up PS PKG Server using the included docker-compose.yml file.
Prompt 2
Explain what the PKG_DIRS and PUBLIC_HOST environment variables do in PS PKG Server.
Prompt 3
Show me how to run PS PKG Server on bare metal with Python and uvicorn.
Prompt 4
Walk me through adding a second PKG library folder to PS PKG Server.

Frequently asked questions

What is ps-pkg-server?

A self-hosted HTTP server that identifies and serves PS4 and PS5 game package files to your own consoles.

What language is ps-pkg-server written in?

Mainly Python. The stack also includes Python, Uvicorn, Docker.

What license does ps-pkg-server use?

The README does not clearly state a license for this project.

How hard is ps-pkg-server to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is ps-pkg-server for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.