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.
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.
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/CUSA00000Orbis 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
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/CUSA00000The 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.
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
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-gameUse --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
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 --lockedThe Rust libraries are orbis-pkg for PKG archives, orbis-pfs for PFS images, and orbis-integrity for shared integrity checks. Build requirements · Testing
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.

