PKGi PS3

PKGi PS3 is a PlayStation 3 port of pkgi (PSVita).

The

pkgi-ps3

.pkg

Comments, ideas, suggestions? You can contact me on Twitter and on my website.

Features

• easy to use: list available downloads, including searching, filtering, and sorting.
• standalone: no PC required, everything happens directly on the PS3.
• automatic downloads: just choose an item, and it will be downloaded by the app to your HDD (

  direct mode

  ) or queued for background download (

  background mode

  ) using the internal Download Manager.
• resumes interrupted downloads: you can stop a download at any time, switch applications, and come back to resume the download later.
• content activation: the app can generate

  .rif

  files for downloaded content (system must be activated)
• content updates: the app can check online for available content updates

Notes:

• queuing up multiple downloads is only supported when using

  background download

  mode.
• background download tasks will only show up after rebooting your PS3.

Download

Get the latest version here.

Changelog

See the latest changes here.

Setup instructions

You need to create a

pkgi.txt

/dev_hdd0/game/NP00PKGI3/USRDIR

Multiple databases

You can also load additional database files:

• pkgi_games.txt

• pkgi_dlcs.txt

• pkgi_themes.txt

• pkgi_avatars.txt

• pkgi_demos.txt

• pkgi_updates.txt

• pkgi_emulators.txt

• pkgi_apps.txt

• pkgi_tools.txt

Items on each of these files will be auto-categorized to the file content type. Note: The app assumes that every database file has the same format, as defined in

dbformat.txt

Online DB update

You can refresh and sync an online database by adding the DB URL(s) to the

config.txt

/dev_hdd0/game/NP00PKGI3/USRDIR

For example:

url http://www.mysite.com/mylist.csv
url_demos http://www.demos.com/otherlist.csv
url_emulators http://www.example.com/emulators.csv

Using this setup,

pkgi.txt

mylist.csv

pgi_demos.txt

otherlist.csv

pkgi_emulators.txt

emulators.csv

Next time you open the app, you'll have an additional menu option called Refresh. When you select it, the local databases will be syncronized with the defined URLs.

DB formats

The application needs a text database that contains the items available for installation, and it must follow the default format definition, or have a custom format definition file.

Default DB format

The default database file format uses a very simple CSV format where each line means one item in the list:

contentid,type,name,description,rap,url,size,checksum

where:

| Column | Description | |--------|-------------| |

contentid

UP0000-NPXX99999_00-0000112223333000

type

name

description

rap

.rap

/dev_hdd0/exdata

.rap

url

.pkg

size

.pkg

checksum

.pkg

Note:

name

description

An example

pkgi.txt

EP0001-FILEMANAG_00-0000000000000000,8,FileManager v1.40,File Manager,,http://github.com/Zarh/ManaGunZ/releases/download/1.40/FileManager_v1.40.pkg,12171120,FAF680636B18AD0B70AA61F48A78C5E42D6972F795F1B82CC434BE3DDE60F00F
UP0001-IRISMAN00_00-VER4880000000000,8,IRISMAN 4.88.1,Backup Manager,,http://github.com/aldostools/IRISMAN/releases/download/4.88/IRISMAN_4.88.pkg,29411984,E6EF607F0002B31BFB148BE4FC9BDBACB4E53110751F0E667C701D40B5290570
EP0001-MANAGUNZ0_00-0000000000000000,8,ManaGunZ v1.40,Backup Manager,,http://github.com/Zarh/ManaGunZ/releases/download/1.40/ManaGunZ_v1.40.pkg,17563040,CE0E4036903E881C08259FD69E777F6BC9CD24E823B471A7B15C88FDDBB2E330
UP0001-PS3SFM001_00-0000000000000000,8,Simple file manager v0.5.2,File Manager,,http://github.com/lmirel/fm_psx/releases/download/v0.5.2/sfm_ps3.pkg,1098800,301F64CC94E9BC442FDAC9199BFB8153AC2430A5E47331C6CF8A25B7881648A6
EP0001-UPDWEBMOD_00-0000000000000000,9,webMAN MOD v1.47.36,Backup Manager,,http://github.com/aldostools/webMAN-MOD/releases/download/1.47.36/webMAN_MOD_1.47.36_Installer.pkg,13580448,

Content types

| Type value | Content type | DB File | |------------|--------------|---------| | 0 | Unknown | | 1 | Game |

pkgi_games.txt

pkgi_dlcs.txt

pkgi_themes.txt

pkgi_avatars.txt

pkgi_demos.txt

pkgi_updates.txt

pkgi_emulators.txt

pkgi_apps.txt

pkgi_tools.txt

User-defined DB format

To use a custom database format, you need to create a

dbformat.txt

/dev_hdd0/game/NP00PKGI3/USRDIR

The

dbformat.txt

;

,

|

Note: For the columns to be properly recognized, use the column tag names defined in the table above.

All the columns are optional. Your database might have more (or less) columns, so any unrecognized column will be skipped.

Example

Example

dbformat.txt

;

;
name;TITLE ID;REGION;description;AUTHOR;TYPE;url;rap;size

Result: only the

name,description,url,rap,size

Example

Example

dbformat.txt

|

|
REGION|TITLE|name|url|rap|contentid|DATE|PKG FILENAME|size|checksum

Result: only the

name,url,rap,contentid,size,checksum

Usage

Using the application is simple and straight-forward:

• Move UP/DOWN to select the item you want to download, and press .
• To see the item's details, press .
• To sort/filter/search press . It will open the context menu. Press again to confirm the new settings, or press to cancel any changes.
  • Press left or right trigger buttons L1/R1 to move pages up or down.
  • Press L2/R2 trigger buttons to switch between categories.

Notes

• RAP data: if the item has

  .rap

  data, the file will be saved in the

  /dev_hdd0/exdata/

  folder.

Q&A

1. Where to get a

   rap

   string?

You can use a tool like RIF2RAP to generate a

.rap

.rif

hexdump

1. Where to get

   .pkg

   links?

You can use PSDLE to find

.pkg

1. Where to remove interrupted/failed downloads to free up disk space?

Check the

/dev_hdd0/tmp/pkgi

.pkg

1. Download speed is too slow!

Optimization is still pending. If

direct

background download

Credits

• Bucanero: Project developer
• mmozeiko: PS Vita pkgi

Building

You need to have installed:

• PS3 toolchain
• PSL1GHT SDK
• Tiny3D library
• YA2D library (an extended version from my repo)
• PolarSSL library (v1.3.9)
• libcurl library (v7.64.1)
• MikMod library
• Mini18n library
• dbglogger library (only required for debug logging)

Run

make

make pkg

.pkg

You can also set the environment variable

PS3LOAD=tcp:x.x.x.x

make run

pkgi-ps3.self

Debugging

To enable debug logging, build PKGi PS3 with

make DEBUGLOG=1

239.255.0.100:30000

$ socat udp4-recv:30000,ip-add-membership=239.255.0.100:0.0.0.0 -

License

pkgi-ps3