Skip to content
AnttiPublic

About

PS4 PKG extractor and update installer for Windows, Linux, and macOS. Inspect PARAM.SFO, verify package integrity, and export merged base/update files. Rust CLI and libraries.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

Orbis

PS4 package tools for desktop and command line

Orbis opens PlayStation 4 PKG files on Windows, macOS, and Linux. Use the desktop app or the orbis command to inspect and extract a package, install a full-file update for shadPS4, or export the base game and its update as a single folder.

Download Orbis · Desktop guide · CLI reference

Choose the orbis-desktop archive for your platform, unpack it, and open Orbis.exe (Windows), Orbis.app (macOS), or Orbis (Linux). For the command line, choose an orbis-cli download. Platform instructions and checksums

The desktop game-folder view and the option to combine --resume with --dry-run in orbis export require Orbis 0.6.0 or later.

Extract a package

Drop a PS4 PKG onto the window. Check the title and version, choose a destination and folder name, then click Extract files. To continue an interrupted extraction, select the same output and turn on Resume an unfinished extraction.

PS4Load open in Orbis, with one unreadable metadata entry and Games/LOAD00044 selected as the extraction folder

To try the package shown above, download PS4Load. For your own game, use its title ID in place of CUSA00000 in the CLI examples.

The examples assume orbis is on your PATH. In PowerShell, you can run the downloaded CLI from its extracted folder, for example .\orbis.exe info game.pkg.

orbis info game.pkg
orbis list game.pkg
orbis extract game.pkg --output Games/CUSA00000

Orbis can read PS4 fake packages (FPKG). If an entry needs a key Orbis lacks, it reports the omission and marks the extraction incomplete. A known package passcode can unlock additional metadata. To check readability and stored hashes without extracting files, run orbis verify game.pkg --integrity. Package keys and passcodes

Install an update for shadPS4

Close the emulator and open the update PKG. Under Install update, select the extracted base folder containing sce_sys. Leave Keep update separate selected and click Check update. Review the versions and space estimate, then click Install update.

orbis install update.pkg --base Games/CUSA00000 --dry-run
orbis install update.pkg --base Games/CUSA00000
orbis status --base Games/CUSA00000

The patch goes into Games/CUSA00000-UPDATE beside the original game. Use a newer full-file update with matching title and content IDs. Orbis cannot apply binary delta patches.

Drop the base game folder onto the window to see the active version. Orbis keeps one rollback point. In this sample, Restore base 01.00… undoes update 01.12. The CLI equivalent is orbis rollback --base Games/CUSA00000.

Sample game CUSA00000 with separate update 01.12 installed, base version 01.00, and a Restore base 01.00 button

To update the base folder in place, select Merge into game folder or pass --merge to orbis install. Keep the adjacent .CUSA00000.orbis-install folder. It holds the originals you need to restore the base before the next update. Merge and recovery

Export a single game folder

Choose Export game… and select the extracted base, or click Export this game… in the game-folder view. Pick a destination outside the game and click Check export. Export and verify copies the base and its separate update to one folder. When a file exists in both, the export uses the updated version. If you merged in place, restore the base and install the update separately first.

orbis export --base Games/CUSA00000 --output ./merged-game --resume
orbis verify-dir ./merged-game

Use --resume from the first run. If the copy is interrupted, repeat the command to check completed files and copy what's missing. Add --dry-run to see how much is left to copy. After moving the export to another drive, open a terminal in the moved folder and run orbis verify-dir . to check its files against the SHA-256 manifest. Export destinations, space requirements, and exFAT

Build from source

From the repository root, run the desktop app or install the CLI with Cargo.

cargo run -p orbis-desktop --locked
cargo install --path orbis-cli --locked

The Rust libraries are orbis-pkg for PKG archives, orbis-pfs for PFS images, and orbis-integrity for shared integrity checks. Build requirements · Testing

Credits and license

videobitva wrote the original Rust libraries and CLI. Andrii Dmytrenko maintains this fork. The original project used shadPS4 and Obliteration as format references, checked extraction results against shadPKG, and drew on the format documentation at PSDevWiki.

Orbis is available under either the MIT or Apache 2.0 license.

About

PS4 PKG extractor and update installer for Windows, Linux, and macOS. Inspect PARAM.SFO, verify package integrity, and export merged base/update files. Rust CLI and libraries.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages