-
Notifications
You must be signed in to change notification settings - Fork 10
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
02b6344
commit 83a8abe
Showing
1 changed file
with
179 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,179 @@ | ||
| # FPKGi - A Server Populated PS4 Content Downloader | ||
| This app allows users to easily download and install their `.pkg` content from a server, directly and functions like [PKGi](https://www.github.com/bucanero/pkgi-ps3). | ||
|
|
||
| > [!NOTE] | ||
| > FPKGi stands for Fake PKG and references modified .pkg files for backported PS4 games. The project is a clone of the original PKGi. | ||
| > This lets you populate the app with your own content via `.json` files locally or from the web, and download from your own servers. | ||
| > It supports any `.pkg `content, provided you have the necessary licenses. If you're using older FW with backported games, you're all set! | ||
| > This tool is for educational and personal use only. Its open-sourced and community-driven, committed to game preservation for the PS4 homebrew community, | ||
| > giving everybody the quick and easy way to view and download and quickly install their offloaded content. | ||
| --- | ||
|
|
||
| ## Setup Instructions | ||
|
|
||
| ### 1. Download [here](https://github.com/ItsJokerZz/FPKGi/releases) and install the build. | ||
|
|
||
| ### 2. Populate Content | ||
| Launch the application to automatically create the necessary directories and `.json` files in the `/data/FPKGi/` folder. | ||
|
|
||
| #### Populate Content Locally | ||
| Edit the `.json` files generated at `/data/FPKGi/ContentJSONs/` to add your content. | ||
|
|
||
| You may also generate / populate, and save the necessary content `.json` via [here](https://www.itsjokerzz.site/projects/FPKGi/gen/).<br><br> | ||
|
|
||
| > [!NOTE] | ||
| > Use bytes for `"size"` and `"release"` must be in the format: `"MM-DD-YYYY"`.<br> | ||
| > Region codes for specifying content regions: `"USA"`, `"JAP"`, `"EUR"`, `"ASIA"`, or `"UNK"`. | ||
| Example `.json` structure: | ||
| ```json | ||
| { | ||
| "DATA": { | ||
| "https://www.example.com/directLinkToContent.pkg": { | ||
| "region": "USA", | ||
| "name": "Content Title", | ||
| "version": "1.00", | ||
| "release": "11-15-2014", | ||
| "size": "1000000000", | ||
| "min_fw": null, | ||
| "cover_url": "https://www.example.com/cover.png" | ||
| } | ||
| } | ||
| } | ||
| ``` | ||
|
|
||
| > [!IMPORTANT] | ||
| > URLs must be direct links to `.pkg` files. Indirect links may cause issues and `"size"` is **REQUIRED!**<br> | ||
| > `"region"`, `"release"`,`"min_fw"`, and the `"cover_url"` are all able to be left `null` where needed. | ||
| #### Populate Content Via Web | ||
| To enable web population, edit the `config.json` file located at `/data/FPKGi`. | ||
|
|
||
| Locate and edit the following section: | ||
| ```json | ||
| "CONTENT_URLS": { | ||
| "games": null, | ||
| "apps": null, | ||
| "updates": null, | ||
| "DLC": null, | ||
| "demos": null, | ||
| "homebrew": null | ||
| } | ||
| ``` | ||
|
|
||
| Replace `null` with URLs pointing to `.json` files containing your content: | ||
| ```json | ||
| "CONTENT_URLS": { | ||
| "games": "https://www.example.com/GAMES.json" | ||
| } | ||
| ``` | ||
|
|
||
| Unspecified fields will default to loading content from local `.json` files. | ||
|
|
||
| --- | ||
|
|
||
| ## Controls & Settings | ||
| ### Navigation | ||
| - **Move Through Items**: Use <kbd>(LS)tick</kbd>/<kbd>(RS)tick</kbd> or use the dpad to navigate. | ||
| - **Select/Download**: Press **** to select or download content. | ||
| - **Page & Category Navigation**: | ||
| - <kbd>L1</kbd>/<kbd>R1</kbd>: Changes pages. | ||
| - <kbd>L2</kbd>/<kbd>R2</kbd>: Changes category. | ||
| - **Press the touchpad to search or filter through content**. | ||
|
|
||
| ### Settings Menu | ||
| - **Press  to open settings**. | ||
| - **Save/Cancel**: | ||
| - Press **** to save current settings changes. | ||
| - Press **** to toggle menu & not save setting. | ||
|
|
||
| ### View Content Information | ||
| - **View Details**: Press **** to view detailed information about the selected content. | ||
|
|
||
| ### Reload Configuration | ||
| - **Reload JSON Files**: Select "Reload JSON Files" in settings, switch categories, or restart the app. | ||
|
|
||
| --- | ||
|
|
||
| ## Features | ||
|
|
||
| ### Core Features | ||
| - **Search**: Quickly find content using keywords. | ||
| - **Sorting**: Organize content by size, name, region, or title ID. | ||
| - **Filtering**: Filter content by type for faster navigation. | ||
| - **View Options**: Toggle between ascending and descending order. | ||
|
|
||
| ### Customization | ||
| - **Background Music**: Toggle the original PKGi background music by [nobodo](https://www.github.com/nobodo). | ||
| - **Custom Backgrounds**: | ||
| - Add images via URL or locally (supports `.png`, `.bmp`, `.jpg`, and `.jpeg`). | ||
| - URL Example: | ||
| ```json | ||
| "background_uri": "https://www.example.com/image.png" | ||
| ``` | ||
| - Local Example: | ||
| ```json | ||
| "background_uri": "/data/FPKGi/Backgrounds/custom.png" | ||
| ``` | ||
| - Reset to default: | ||
| ```json | ||
| "background_uri": null | ||
| ``` | ||
|
|
||
| ### Download Management | ||
| - **Background Downloads**: Supports unlimited simultaneous downloads with automatic installation and rest-mode compatibility. | ||
| - **Foreground Downloads**: Single download support, with a queue feature planned in future updates.<br> | ||
|
|
||
| - You can edit the path within the app's settings, or manually through the '.config.json' like so: | ||
| ```json | ||
| "downloadPath": "/mnt/usb0/" | ||
| ``` | ||
|
|
||
| - When using, you must provide '/user/' before your path, unless it's in '/mnt/', for example: | ||
| ```json | ||
| "downloadPath": "/user/data/folder/" | ||
| ``` | ||
|
|
||
| - To reset, simply set `null` or type the default path: | ||
| ```json | ||
| "downloadPath": "/user/data/FPKGi/Downloads/" | ||
| ``` | ||
| --- | ||
|
|
||
| ### Troubleshooting Error Code `CE-36441-8` | ||
| > [!WARNING] | ||
| > **THIS WILL BLOCK ACCESS to Sony CDN & API, and other related services.** | ||
| <br> | ||
| If you encounter this error, follow these steps to resolve it: | ||
|
|
||
| 1. **Enable Debug Menu**: | ||
| - Open the **GoldHEN** menu. | ||
| - Navigate to **Debug Settings** and enable **Full Menu**. | ||
|
|
||
| 2. **Configure NP Environment**: | ||
| - Go to the PS4's settings. | ||
| - Navigate to `Debug Settings > PlayStation Network`. | ||
| - Set **NP Environment** to `sp-int`. | ||
|
|
||
| 3. **Restart the Console**. | ||
|
|
||
| This solution is sourced from [r/ps4homebrew](https://www.reddit.com/r/ps4homebrew/comments/1ctvvg2/comment/l4exrpy/), where several users, including myself, have found it to be effective. | ||
|
|
||
| **I am planning on looking into an actual fix rather than a work around for this issue, if you have any ideas, please make a pull-request.** | ||
|
|
||
| --- | ||
|
|
||
| ## Special Thanks | ||
| - **Original App Creator**: [Bucanero](https://www.github.com/bucanero) | ||
| - **Original PKGi Music**: [nobodo](https://www.github.com/nobodo) | ||
|
|
||
| **[OOSDK's Discord](https://www.discord.com/invite/GQr8ydn)** | ||
| - TheMagicalBlob, LightningMods, Al-Azif, | ||
| - Da Puppeh, Kernel Panic, ainofthewired, | ||
|
|
||
| and many other amazing people, thank you all! | ||
|
|
||
| --- | ||
|
|
||
| Join the [Discord server](https://discord.com/invite/RjG4Whf) for updates, support, and discussions! Contact me directly or submit an issue for further support where needed! |