Usage Guide

This comprehensive guide explores the interface, controls, and advanced features of PKGi PS3, ensuring you get the most out of the application's capabilities.

Controls Reference

PKGi PS3 fully supports both digital (D-Pad) and analog input. The interface is designed to be completely navigable without requiring an external keyboard.

Button Action
Up / Down Move selection cursor up / down.
Left Analog Stick Move selection cursor (supports deadzone thresholding).
L1 / R1 Page up / Page down through the list for rapid navigation.
L2 / R2 Switch between content categories (e.g., Games, DLCs, Themes).
Triangle ($\Delta$) Open the Options/Sort/Filter menu. Press again to apply and close.
Square ($\square$) Open the "Details" screen to see the TMDB icon, RAP status, and metadata.
X / O Accept / Cancel. (Automatically adjusts based on your PS3's system region SYSUTIL_SYSTEMPARAM_ID_ENTER_BUTTON_ASSIGN).
Select Show credits, version information, and GitHub link.
Start (Reserved; use the PS button to exit the application).

In-Depth: Download Modes

PKGi PS3 supports two entirely different architectures for downloading packages. You can toggle between them by pressing Triangle to open the menu and navigating to Options: Direct DL / Back. DL.

1. Direct Download (Direct DL)

In Direct Download mode, the application manages the HTTP/HTTPS request natively using libcurl while the application remains open.

  • Workflow: The file is downloaded sequentially to a temporary folder (/dev_hdd0/tmp/pkgi).
  • Installation: Once the download reaches 100%, the app internally triggers a rename and moves the file to the internal Package Manager directory (/dev_hdd0/vsh/game_pkg).
  • Resuming: If you exit the app or your network drops, a .resume file is kept. Re-selecting the exact same item in the list later will read the .resume file and append new data to the existing .pkg via an HTTP Range request (CURLOPT_RESUME_FROM_LARGE).
  • Trade-offs: You must leave the application open and your screen on. Download speeds may be slightly bottlenecked by the application's UI rendering loop.

2. Background Download (Back. DL)

In Background Download mode, PKGi PS3 delegates the actual downloading process to the PlayStation 3's native OS Download Manager (sys_net background tasks).

  • Workflow: When you select an item, PKGi does not download the .pkg. Instead, it fetches the file size via an HTTP HEAD request. It then generates specific internal Sony database files (d0.pdb, d1.pdb, f0.pdb, and an ICON_FILE) inside the PS3's task queue directory (/dev_hdd0/vsh/task/).
  • The Reboot Requirement: Because the PS3 OS only indexes background tasks on startup, background download tasks will only show up on the XMB after rebooting your PS3.
  • Trade-offs: Allows you to queue multiple massive games, reboot, and play other games while they download natively in the background. Highly recommended for files larger than 2GB.

Activation & Licenses (.rap / .rif)

Most PlayStation Network packages are DRM-protected and require a license to execute.

RAP Files

If your pkgi.txt database includes a 32-character hex string in the rap column, PKGi PS3 will automatically create a .rap file in /dev_hdd0/exdata/ when you initiate the download.

On-Device RIF Generation

Traditionally, users needed homebrew like PSNPatch or ReactPSN to convert .rap files into activated .rif files. PKGi PS3 can do this automatically.

If your console is properly activated with a PSN account (meaning a valid act.dat exists in /dev_hdd0/home/<user_id>/exdata/act.dat), PKGi PS3 will:

  1. Decrypt the .rap into a klicensee using AES-ECB-128.
  2. Fetch your console's unique IDPS (via sys_ss_appliance_info_manager).
  3. Cryptographically sign a new .rif file using Elliptic Curve Cryptography (ECDSA) exactly as the official PSN store would.

Note: This feature requires your PS3 to have been activated on PSN at least once. If act.dat is missing, .rif generation will be safely skipped, and you will need to rely on standard RAP activation methods (like CFW Cobra's on-the-fly RAP loading).

Automatic Content Updates

When viewing an item's Details page (by pressing Square), you can press Square a second time to trigger an Update Scan.

PKGi PS3 will query the official Sony API (https://a0.ww.np.dl.playstation.net/tpl/np/...) to check if patches exist for that specific Title ID. If patches are found, they are dynamically appended to your database list as Update types, allowing you to download game patches directly without needing to launch the game first.

Maintenance & Freeing Up Space

If a Direct Download fails (e.g., HDD full, internet disconnect), the partial file is preserved to allow resuming. However, if you decide you no longer want the file, this consumes "invisible" HDD space.

To clean up interrupted downloads:

  1. Open a PS3 File Manager (e.g., Irisman, multiMAN) or use FTP.
  2. Navigate to /dev_hdd0/tmp/pkgi/.
  3. Delete any .pkg and .resume files matching the Title ID of the aborted download.

Troubleshooting Common Issues

  • Missing Icons: The app fetches icons from TMDB based on the Title ID. If an icon fails to load, the Title ID might be non-standard, or TMDB lacks artwork for it. A generic fallback icon will be used.
  • HTTP Error / Connection Closed: Often caused by dead links in your custom database, or your PS3's clock being wildly out of sync, causing SSL/TLS 1.2 certificate verification to fail.