base on A PlayStation Portable (PSP) package download tool # PKGi PSP [![Downloads][img_downloads]][pkgi_downloads] [![Release][img_latest]][pkgi_latest] [![License][img_license]][pkgi_license] [](https://github.com/bucanero/pkgi-psp/actions/workflows/build.yml) [](https://twitter.com/dparrino) **PKGi PSP** is a PlayStation Portable port of [pkgi-ps3](https://github.com/bucanero/pkgi-ps3). This homebrew app allows to download and install `.pkg` files directly on your PSP.  **Comments, ideas, suggestions?** You can [contact me](https://github.com/bucanero/) on [Twitter](https://twitter.com/dparrino) and on [my website](http://www.bucanero.com.ar/). # Features * **easy to use:** list available downloads, including searching, filtering, and sorting. * **standalone:** no PC required, everything happens directly on the PSP. * **automatic downloads:** just choose an item, and it will be downloaded by the app to your Memory Stick (`ms0:/PKG/`). * **resumes interrupted downloads:** you can stop a download at any time, switch applications, and come back to resume the download later. * **localization support:** Finnish, French, German, Indonesian, Italian, Polish, Portuguese, Spanish, Turkish ### Notes: * **content activation:** downloaded content requires a valid license to run. If your PSP hasn't been activated, you can use one of the following plugins: - [npdrm_free plugin](https://github.com/qwikrazor87/npdrm_free) (PSP/PS1/PCEngine games and DLCs) - [npdrm_free_mod plugin](https://github.com/lusid1/npdrm_free_mod) (PSP/PS1 games only) - [nploader_mod](https://github.com/lusid1/nploader_mod) (PSP DLCs only) # Download Get the [latest version here][pkgi_latest]. ### Changelog See the [latest changes here](CHANGELOG.md). # Setup instructions You need to create a [`pkgi.txt`](#sample-db-file) file in `ms0:/PSP/GAME/PKGI/` that contains the items available for installation. The text database format is user customizable. Check [this section](#user-defined-db-format) to learn how to define your own custom DB format. ## Multiple databases You can also load additional database files: - `pkgi_games.txt` - `pkgi_dlcs.txt` - `pkgi_themes.txt` - `pkgi_psx.txt` - `pkgi_demos.txt` - `pkgi_updates.txt` - `pkgi_emulators.txt` - `pkgi_apps.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` file in `ms0:/PSP/GAME/PKGI/`. For example: ``` url_games 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_games.txt` will be updated with `http://www.mysite.com/mylist.csv`, - `pkgi_demos.txt` with `http://www.demos.com/otherlist.csv`, - and `pkgi_emulators.txt` with `http://www.example.com/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](#default-db-format), or have a [custom format definition](#user-defined-db-format) 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` | is the full content id of the item, for example: `UP0000-NPXX99999_00-0000112223333000`. | `type` | is a number for the item's content type. See the [table below](#content-types) for details. (set it to 0 if unknown) | `name` | is a string for the item's name. | `description` | is a string for the item's description. | `rap` | the 16 hex bytes for a RAP file, if needed by the item (`.rap` files will be created on `ms0:/PKG/RAP`). Leave empty to skip the `.rap` file. | `url` | is the HTTP/HTTPS/FTP/FTPS URL where to download the `.pkg` file. | `size` | is the size in bytes of the `.pkg` file, or 0 if unknown. | `checksum` | is a SHA256 digest of the `.pkg` file (as 32 hex bytes) to make sure the file is not tampered with. Leave empty to skip the check. **Note:** `name` and `description` cannot contain newlines or commas. ### Sample DB file An example `pkgi.txt` file following the `contentid,type,name,description,rap,url,size,checksum` format: ``` U00001-NP0APOLLO_00-0000000000000000,8,Apollo Save Tool v1.3.0,Save-game manager,,https://github.com/bucanero/apollo-psp/releases/download/v1.3.0/apollo-psp.zip,6885196,DFF88635A044F319686231ACABB548CC42EA1CF3A992856572C7AF20F70D30ED U00001-CMFILEMGR_00-0000000000000000,8,CM File Manager v4.10,File manager,,https://github.com/joel16/CMFileManager-PSP/releases/download/v4.10/CMFileManager-PSP.zip,1815998,7A5FD10184546AB993A4D5F3054BCBA9E9B7A1C569EE26E366F1F5CC9DA5A554 UP0001-PSPTOOL10_00-0000000000000000,8,PSP Tool v1.00,PSP Tool,,https://archive.org/download/psp-tool.-7z/PSP%20Tool.zip,5023819, UP0001-PSPFILER6_00-0000000000000000,8,PSP Filer v6.6,File manager,,https://wololo.net/download.php?f=filer6.6.zip,1295106, UP0001-NZPORTABL_00-0000000000000000,1,Nazi Zombies: Portable,Nightly 64 Mb,,https://github.com/nzp-team/nzportable/releases/download/nightly/nzportable-psp-64mb.zip,36163686, 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 ``` ### Content types | Type value | Content type | DB File | |------------|--------------|---------| | 0 | Unknown | | 1 | Game | `pkgi_games.txt` | 2 | DLC | `pkgi_dlcs.txt` | 3 | Theme | `pkgi_themes.txt` | 4 | PSX | `pkgi_psx.txt` | 5 | Demo | `pkgi_demos.txt` | 6 | Update | `pkgi_updates.txt` | 7 | Emulator | `pkgi_emulators.txt` | 8 | Application | `pkgi_apps.txt` ## User-defined DB format To use a custom database format, you need to create a `dbformat.txt` file, and save it on `ms0:/PSP/GAME/PKGI/`. The `dbformat.txt` definition file is a 2-line text file: * Line 1: the custom delimiter character (e.g.: `;`, `,`, `|`, etc.) * Line 2: the column names for every column in the custom database, delimited by the proper delimiter defined in line 1 **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`, for a database using semi-colon (`;`) as separator: ``` ; name;TITLE ID;REGION;description;AUTHOR;TYPE;url;rap;size ``` **Result:** only the `name,description,url,rap,size` fields will be used. ### Example Example `dbformat.txt`, for a database using character pipe (`|`) as separator: ``` | REGION|TITLE|name|url|rap|contentid|DATE|PKG FILENAME|size|checksum ``` **Result:** only the `name,url,rap,contentid,size,checksum` fields will be used. # Usage Using the application is simple and straight-forward: - Move <kbd>UP</kbd>/<kbd>DOWN</kbd> 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 <kbd>L1</kbd>/<kbd>R1</kbd> to move pages up or down. - Press <kbd>LEFT</kbd>/<kbd>RIGHT</kbd> buttons to switch between categories. ### Notes - **RAP data:** if the item has `.rap` data, the file will be saved in the `ms0:/PKG/RAP/` folder. # Q&A 1. Where to get a `rap` string? You can use a tool like RIF2RAP to generate a `.rap` from your existing `.rif` files. Then you can use a tool like `hexdump` to get the hex byte string. 2. Where to get `.pkg` links? You can use [PSDLE][] to find `.pkg` URLs for the games you own. Then either use the original URL, or host the file on your own web server. 3. Where to remove interrupted/failed downloads to free up disk space? Check the `ms0:/PKG/` folder - each download will be in a separate `.pkg` file by its content ID. Simply delete the file and start again. 4. Download speed is too slow! Optimization is still pending. (Optional) Set `Power Save Settings` -> `WLAN Power save` -> `OFF` , if you want to speed up the download process. # Credits * [Bucanero](http://www.bucanero.com.ar/): Project developer ## Acknowledgements * [mmozeiko](https://github.com/mmozeiko/): [pkgi](https://github.com/mmozeiko/pkgi) (PS Vita), [pkg2zip](https://github.com/mmozeiko/pkg2zip) * [qwikrazor87](https://github.com/qwikrazor87/): [Depackager](https://github.com/bucanero/psptools/tree/master/depackager) # Building You need to have installed: - [PSP SDK](https://github.com/pspdev/) - [mbedTLS](https://github.com/pspdev/psp-packages/tree/master/mbedtls) library - [cURL](https://github.com/pspdev/psp-packages/tree/master/curl) library - [Mini18n](https://github.com/bucanero/mini18n) library - [dbglogger](https://github.com/bucanero/dbglogger) library (only required for debug logging) Run `cmake . && make` to create a release build. If you want to create a `.zip` file, run `make createzip`. ## Debugging To enable debug logging, pass `-DPKGI_ENABLE_DEBUG=ON` argument to `cmake`. The application will write debug messages to ms0:/pkgi-psp.log You can also set the `PSPIP` environment variable to your PSP's IP address, and use `make send` to upload `EBOOT.PBP` directly to the `ms0:/PSP/GAME/PKGI` folder. # License `pkgi-psp` is released under the [MIT License](LICENSE). [PSDLE]: https://repod.github.io/psdle/ [socat]: http://www.dest-unreach.org/socat/ [pkgi_downloads]: https://github.com/bucanero/pkgi-psp/releases [pkgi_latest]: https://github.com/bucanero/pkgi-psp/releases/latest [pkgi_license]: https://github.com/bucanero/pkgi-psp/blob/main/LICENSE [img_downloads]: https://img.shields.io/github/downloads/bucanero/pkgi-psp/total.svg?maxAge=3600 [img_latest]: https://img.shields.io/github/release/bucanero/pkgi-psp.svg?maxAge=3600 [img_license]: https://img.shields.io/github/license/bucanero/pkgi-psp.svg?maxAge=2592000 ", Assign "at most 3 tags" to the expected json: {"id":"2902","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"