Skip to content

About

PKG Viewer by Loopayeh: view PS3/PS4/PS5 package info and cover art

Topics

Resources

Stars

170 stars

Watchers

5 watching

Forks

Latest commit

 

History

192 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PKG Viewer — PS2 / PS3 / PS4 / PS5 / Switch / Wii U / Xbox 360

screenshot trophies

PKG Viewer shows what's inside a PlayStation or Switch game file without extracting it: cover art, title, Title ID, region, version, and required firmware. Retail (original) PKGs fully supported — including split multi-part sets.

Works with .pkg packages, PS2/PS3 .iso disc images, .exfat / .ffpfsc / .ffpkg images, Switch .nsp / .xci files, Xbox 360 (GOD/STFS/ISO/XEX), Wii U NUS folders, and game folders.

Download

Get PKGViewer-Setup-X.Y.Z.exe (Windows) or PKGViewer-macOS-arm64-X.Y.Z.zip (Apple Silicon) / PKGViewer-macOS-x86_64-X.Y.Z.zip (Intel) from Releases — no Python needed, no admin needed.

Windows security warning

The builds are unsigned, so Windows may warn you before running them. This is about the missing publisher signature, not about the file being unsafe.

  • Windows protected your PC (SmartScreen, "Unknown publisher") — click More info → Run anyway.
  • Smart App Control blocked an app (Windows 11 with Smart App Control On) — this one has no "Run anyway" button and cannot be bypassed by unblocking the file or adding a Defender exclusion. Run from source instead, or turn Smart App Control off.

Full walkthrough and what does not work: docs/troubleshooting.md.

Why the installer

file icons

Grab PKGViewer-Setup-X.Y.Z.exe from Releases — no admin needed:

  • every format gets its own icon (.pkg / .exfat / .ffpfsc / .ffpkg / .nsp / .xci) and opens on double-click — no Open With setup
  • shows up in Settings → Default apps, so all six formats go Always in one place
  • updates itself in place, no reinstall hassle
  • uninstall wipes everything clean (files, icons, registry)

Features

  • Cover art preview (icon0.png, pic0.png, …) with Save / Copy to clipboard — online covers (PlayStation Store, ps2-covers, GameTDB, XboxUnity, Nintendo IDBE), cached offline
  • Spec card: Title ID, Content ID, version, region, Min. System, SDK, DRM
  • Latest patch version per game (PS5/PS4) with PKG-vs-latest compare
  • Files tab: folder tree built from entry paths (PS3 discs/folders, ISOs), sized per folder — single-file Extract with rename, trophy00.trp contents
  • Trophies tab: decrypted trophy list (name, grade, hidden) with icons, banner art, Save icons export
  • OFC (Official) / FPKG (Fake) detection + badges for PS4 and PS5 (incl. split parts)
  • Details tab: curated param.sfo / param.json, Show all for the full dump
  • Drag & drop: PKG files, exFAT / ffpfsc / ffpkg images, Switch NSP / XCI files, and game folders onto the window
  • Rename: clean uniform names from PKG info (Title - TID - vVersion - Region, e.g. Elden Ring - PPSA04863 - v1.06 - EU) — single file via the Rename button (preview + header Undo), or many at once via the Batch button / dropping them all (batch dialog with preview + All/None + revert log); folders are scanned for game files; split multi-part sets stay together; Revert restores original names from any revert log
  • AMPR / LZ4 asset containers (LIZARD dumps): listed with size in the spec card + Files tab
  • Copy/paste works in every text field, on any keyboard layout
  • Self-updating: silent check at startup, header button lights up on new release
  • Rename patterns in both dialogs: {title} {tid} {cid} {version} {region} {type} {orig} presets (Title ID only, Content ID, append [Title ID] to the original name) or a custom pattern with live preview — the last preset, pattern and Title/Title ID/Version/Region ticks are remembered
  • CLI mode: pkgviewer.py --info file.pkg (also .nsp / .xci) — batch: pkgviewer.py --batch-rename folder [--recursive] [--apply] [--name-pattern "{orig} [{tid}]"] (dry run without --apply) — revert: pkgviewer.py --revert batch_rename_*.log [--apply]

Usage

Drag & drop a .pkg / .exfat / .ffpfsc / .ffpkg / .nsp / .xci file or a game folder onto the exe or the open window, or use Open. To run from source (needs Python 3 + Pillow + tkinterdnd2 + mkpfs + pytsk3 + cryptography):

PKGViewer.bat

Supported formats

  • PS2 disc images (.iso) — SYSTEM.CNF serial/version/VMODE, file listing
  • PS3 packages (.pkg) — retail + debug NPDRM, decrypted listing
  • PS3 game folders — NPDRM and PS3_GAME layouts
  • PS4 / PS5 packages (.pkg) — game, DLC, update, retail + split parts
  • PS5 disk images (.exfat) — game dumps
  • PS5 compressed images (.ffpfsc) — game dumps
  • PS5 UFS2 images (.ffpkg) — game dumps (needs pytsk3 from source)
  • PS5 app folders — extracted game folder (incl. LIZARD AMPR/LZ4 dumps)
  • Switch packages (.nsp) — game, update, DLC; official title + icon from Control NCA with prod.keys (put it next to the exe or in %APPDATA%\PKGViewer\), raw file listing without keys; per-NCA type/key info, readable firmware requirement
  • Switch gamecard images (.xci) — partition + file listing, cartridge info, title/icon from the secure partition
  • Wii U NUS folders — TMD title/version/contents, official Nintendo icons
  • Xbox 360 GOD folders + STFS packages — title/Media/Title ID, data parts, embedded thumbnail, online XboxUnity covers
  • Xbox 360 ISO / extracted folders / XEX — XDVDFS listing, version/disc from XEX, TU check

Build from source

pip install pyinstaller pillow
python -m PyInstaller --noconfirm --clean --onefile --windowed --name PKGViewer --icon assets\logo.ico --add-data "assets;assets" --add-data "assets_about.png;." --collect-submodules PIL pkgviewer.py

Support

برام یه قهوه بخر

☕ برام یه قهوه بخر — coffeebede.com/loopayeh (🇮🇷 برای ایران — حمایت تومانی)

If this tool was useful, you can also support me internationally with USDT (BEP-20 / BNB Smart Chain):

0x839a30D52Ef7D2b53e818b9931efd7FE6F472e50

Pay via Trust Wallet

Credits

  • PS4 extract/build engine: LibOrbisPkg by maxton (via PkgEditor). Optional orbis-pub-gen/orbis-pub-chk (Sony/OpenOrbis SDK tools, user-supplied).
  • PS5 files are view-only (no extract/build, no outside tools).
  • .ffpfsc / inner-exFAT reading via mkpfs library by PSBrew (RenanGBarreto + contributors incl. rdmrocha, drakmor) — GPLv3, bundled.
  • .ffpkg (UFS) reading via pytsk3 (Sleuth Kit bindings).
  • Switch NCA/NACP parsing follows hactool (SciresM) layout; decrypt needs user-supplied prod.keys (dump it yourself with Lockpick_RCM) — no keys bundled.
  • Patch-version lookup: prosperopatches.com / orbispatches.com.
  • PKG Viewer itself (parsing, UI, rename, trophies, Switch support) is original code — no vendored third-party code bundled.

License

MIT — see LICENSE.

Contact

Telegram: @loopayeh

About

PKG Viewer by Loopayeh: view PS3/PS4/PS5 package info and cover art

Topics

Resources

Stars

170 stars

Watchers

5 watching

Forks

Releases

Packages

Contributors

Languages