manos555555--PS5-Suite/lib-prospero-pkg/docs/README.md

LibProsperoPkg Documentation

This folder contains the technical documentation for LibProsperoPkg, a .NET 10 / C# 14 library for building and inspecting PS5 packages.

Contents

Document	Description
getting-started.md	Install the SDK, build the library, and produce your first package.
api-overview.md	The public API, organized by namespace, with usage notes.
implementation-status.md	A precise breakdown of what is implemented and what is still missing.
ps5-pkg-format.md	A technical write-up of the PS5 package format and the end-to-end creation process.

At a glance

LibProsperoPkg turns a prepared PS5 application folder into a complete, installable package in-process. The pipeline is:

prepared folder (sce_sys/ + eboot + data)
        │
        ▼  optional fake-sign of raw ELF modules (FakeSignSelfModules / LicenseFree)
        │
        ▼  inner PFS layout (ProsperoPfsLayout)
   plaintext inner PFS image
        │
        ▼  data-first inner image (raw-concatenated per-file payloads + naps_pkg_layout.dat)
        │
        ▼  outer PFS + metadata (ProsperoPkgBuilder)
   \x7FCNT metadata container
        │
        ▼  finalize + install-metadata archive (ProsperoFihBuilder)
   \x7FFIH debug image  ──►  installable on a debug-mode console

The library also has a read side. ProsperoPackageExtractor inspects and unpacks debug packages, ProsperoDiscBackup reassembles split app_0 / app_sc backups from an app.json manifest, and the License and NpDrm namespaces read rif licences and package content-info. ProsperoBackupConverter closes the loop from the read side back to the build side: it turns a decrypted backup into a debug fPKG by substituting each executable with its decrypted ELF and fake-signing it. See api-overview.md for the full surface and ps5-pkg-format.md §9–§11 for the RIF, disc-backup and extraction formats.