{"id":26731594,"url":"https://github.com/itsjokerzz/fpkgi","last_synced_at":"2025-04-05T14:10:08.926Z","repository":{"id":269677636,"uuid":"908144972","full_name":"ItsJokerZz/FPKGi","owner":"ItsJokerZz","description":"FPKGi is an open-source clone of the PKGi homebrew by Bucanero for PSP, Vita, and PS3. It retains the beloved functionality, UI, background image, and music while bringing the experience back to the latest console generations. It supports custom fake package (FPKG) content via .json files \u0026 more! It's ideal for game preservation and personal use.","archived":false,"fork":false,"pushed_at":"2025-04-03T04:04:14.000Z","size":970887,"stargazers_count":128,"open_issues_count":0,"forks_count":12,"subscribers_count":10,"default_branch":"nightly","last_synced_at":"2025-04-05T14:09:59.575Z","etag":null,"topics":["fpkg","homebrew","pkgi","ps4","ps5"],"latest_commit_sha":null,"homepage":"https://www.itsjokerzz.site/projects/FPKGi/gen/","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ItsJokerZz.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-25T09:01:15.000Z","updated_at":"2025-04-04T22:39:16.000Z","dependencies_parsed_at":"2025-03-17T22:30:50.016Z","dependency_job_id":null,"html_url":"https://github.com/ItsJokerZz/FPKGi","commit_stats":null,"previous_names":["itsjokerzz/fpkgi"],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ItsJokerZz%2FFPKGi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ItsJokerZz%2FFPKGi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ItsJokerZz%2FFPKGi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ItsJokerZz%2FFPKGi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ItsJokerZz","download_url":"https://codeload.github.com/ItsJokerZz/FPKGi/tar.gz/refs/heads/nightly","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247345856,"owners_count":20924102,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fpkg","homebrew","pkgi","ps4","ps5"],"created_at":"2025-03-28T00:25:50.116Z","updated_at":"2025-04-05T14:10:08.903Z","avatar_url":"https://github.com/ItsJokerZz.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FPKGi - A Server-Based PS4 \u0026 PS5 Content Installer\n\n#### Important Notice: On PS5, an internet connection is currently required for the app to load. This will be resolved with the next **\"etaHEN\"** release. Until then, please ensure you have an active internet connection at launch.\n\n\u003e [!NOTE]\n\u003e FPKGi (Fake PKG Installer) is an open-source homebrew app for installing modified .pkg files on the PS4 and PS5. Inspired by the original PKGi for PSP, Vita, and PS3, it enables you to manage and install content via .json files—from your device, a local network, or the web—and supports package downloads from your private server. Designed for educational and personal use, FPKGi promotes game preservation in the PlayStation homebrew scene by streamlining content browsing, downloading, and installation. For best performance, offload your files to a NAS and run a web server with Node.js or Python, then pass the content URL to your .json files.\n\n\u003e [!IMPORTANT]  \n\u003e Use FPKGi responsibly and in accordance with the laws of your country. This tool is intended solely for legal, educational, and personal use. Do not use FPKGi for piracy or any other illegal activities. Always download FPKGi from our official GitHub repository, via pkg-zone.com, or through the Homebrew Store, and avoid third-party sources. We assume no responsibility to any damage from malicious downloads and/or legal issues.\n\n## Setup Instructions\n#### Download the Latest Version:\n   - Get the latest compiled package from the [Releases](https://github.com/ItsJokerZz/FPKGi/releases) or visit [pkg-zone.com](https://pkg-zone.com/details/FPKGI13337).\n\n#### Install the Package:\n   - Choose your preferred method to install the package on your console.\n   - Alternatively, you can install directly from LightningMods' [Homebrew Store](https://github.com/LightningMods/PS4-Store).\n\n### Populate Content\nLaunch the app to automatically create the necessary directories and `.json` files in the `/user/data/FPKGi/` folder.\n\n#### Populate Content Locally\nEdit the `.json` files generated at `/user/data/FPKGi/ContentJSONs/` to add your content. \u003cbr\u003e\n**You can also generate / populate, and save the necessary `.json` file [here](https://www.itsjokerzz.site/projects/FPKGi/gen/) on my site.**\n\n\u003e [!NOTE]\n\u003e Use bytes for `\"size\"` and for specifying content's region: `\"USA\"`, `\"JAP\"`, `\"EUR\"`, `\"ASIA\"`, or `null`.\n\n### Example `.json` structure:\n```json\n{\n    \"DATA\": {\n        \"https://www.example.com/directLinkToContent.pkg\": {\n            \"region\": \"USA\",\n            \"name\": \"Content Title\",\n            \"version\": \"1.00\",\n            \"release\": \"11-15-2014\",\n            \"size\": 1000000000,\n            \"min_fw\": null,\n            \"cover_url\": \"https://www.example.com/cover.png\"\n        }\n    }\n}\n```\n\n\u003e [!IMPORTANT]  \n\u003e Please ensure the size is as accurate as possible to prevent issues with downloading! The following fields can be \u003cbr\u003e left as `null`\nwhere applicable: `\"version\"`, `\"region\"`, `\"release\"`, `\"min_fw\"`, and `\"cover_url\"` if you decide.\n\n#### Populate Content Via Web\nTo enable web population, edit the `config.json` file located at `/user/data/FPKGi/` and enable it in the menu.\n\n### Locate and edit the following section:\n```json\n    \"CONTENT_URLS\": {\n      \"PS1\": null,\n      \"PS2\": null,\n      \"PSP\": null,\n      \"games\": null,\n      \"apps\": null,\n      \"updates\": null,\n      \"DLC\": null,\n      \"demos\": null,\n      \"homebrew\": null,\n      \"emulators\": null,\n      \"themes\": null\n    }\n```\n\n#### Replace `null` with URLs pointing to `.json` files containing your content:\n```json\n    \"CONTENT_URLS\": {\n      \"games\": \"https://www.example.com/GAMES.json\"\n    }\n```\n\nUnspecified fields will default to loading content from local `.json` files.\n\n## Controls \u0026 Settings\n### Navigation\n- **Move Through Items**: Use **\u003ckbd\u003e(LS)tick\u003c/kbd\u003e/\u003ckbd\u003e(RS)tick\u003c/kbd\u003e** or use the dpad to navigate.\n- **Select/Download**: Press **![X](https://www.github.com/bucanero/pkgi-ps3/raw/master/data/CROSS.png)** to select or download content.\n- **Page \u0026 Category Navigation**:\n  - **\u003ckbd\u003eL1\u003c/kbd\u003e/\u003ckbd\u003eR1\u003c/kbd\u003e**: Changes pages.\n  - **\u003ckbd\u003eL2\u003c/kbd\u003e/\u003ckbd\u003eR2\u003c/kbd\u003e**: Changes category.\n- **View Details**: Press **![square](https://www.github.com/bucanero/pkgi-ps3/raw/master/data/SQUARE.png)** to view detailed information about the selected content.\n\n### Settings Menu\n- Press **![triangle](https://www.github.com/bucanero/pkgi-ps3/raw/master/data/TRIANGLE.png)** to open settings.\n- **Save/Cancel**:\n  - Press **![triangle](https://www.github.com/bucanero/pkgi-ps3/raw/master/data/TRIANGLE.png)** to save current settings changes.\n  - Press **![circle](https://www.github.com/bucanero/pkgi-ps3/raw/master/data/CIRCLE.png)** to toggle menu \u0026 not save setting.\n \n\u003cbr\u003e\n\n- **Press the touchpad to search or filter through content by title ID or name.**\n  \n## Features\n### Core Features\n- **Search**: Quickly find content using keywords.\n- **Sorting**: Organize content by size, name, region, or title ID.\n- **Filtering**: Filter content by type for faster navigation.\n- **View Options**: Toggle between ascending and descending order.\n\n### Customization\n- **Background Music**: Toggle the original PKGi background music by [nobodo](https://www.github.com/nobodo).\n- **Custom Backgrounds**:\nAdd images via URL or locally (supports `.png`, `.bmp`, `.jpg`, and `.jpeg`).\n  - URL Example:\n    ```json\n    \"background_uri\": \"https://www.example.com/image.png\"\n    ```\n  - Local Example:\n    ```json\n    \"background_uri\": \"/user/data/FPKGi/Backgrounds/custom.png\"\n    ```\n  - Reset to default:\n    ```json\n    \"background_uri\": null\n    ```\n\n### Download Management\n- **Background Downloads**: Supports simultaneous downloads with automatic installation and rest-mode support.\n- **Foreground Downloads**: Single download support, with a queue feature planned in future updates.\u003cbr\u003e\n\n    - You can edit the path within the app's settings, or manually through the `config.json` like so:\n    ```json\n    \"downloadPath\": \"/mnt/usb0/\"\n    ```\n\n    ```json\n    \"downloadPath\": \"/user/data/folder/\"\n    ```\n    \n    - To reset, simply set `null` or type the default path:\n    ```json\n    \"downloadPath\": \"/user/data/FPKGi/Downloads/\"\n    ```\n    \n## How to Build\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cstrong\u003ePrerequisites\u003c/strong\u003e\u003c/summary\u003e\n  \u003cul\u003e\n    \u003cli\u003e\u003cstrong\u003eUnity Hub\u003c/strong\u003e \u0026 \u003cstrong\u003eUnity 2017.2.0p1\u003c/strong\u003e (or a compatible version)\u003c/li\u003e\n    \u003cli\u003e\u003cstrong\u003ePS4 SDK 4.50+\u003c/strong\u003e with Unity integration\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://github.com/CyB1K/PS4-Fake-PKG-Tools-3.87\" target=\"_blank\"\u003ePS4 Fake PKG Tools 3.87\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://www.dotnet.microsoft.com/en-us/download/dotnet-framework/net46\" target=\"_blank\"\u003e.NET 4.6 Developer Pack\u003c/a\u003e\u003c/li\u003e\n  \u003c/ul\u003e\n\n  \u003cdetails\u003e\n    \u003csummary\u003e\u003cstrong\u003eIncluded Precompiled Dependencies\u003c/strong\u003e\u003c/summary\u003e\n    \u003cul\u003e\n      \u003cli\u003e\u003ca href=\"https://www.github.com/SaladLab/Json.Net.Unity3D\" target=\"_blank\"\u003eJson.Net.Unity3D\u003c/a\u003e\u003c/li\u003e\n      \u003cli\u003e\u003ca href=\"https://www.github.com/ItsJokerZz/store-api\" target=\"_blank\"\u003eHB Store's API\u003c/a\u003e\u003c/li\u003e\n      \u003cli\u003e\u003ca href=\"https://www.github.com/ItsJokerZz/UnityOrbisBridge\" target=\"_blank\"\u003eUnityOrbisBridge\u003c/a\u003e\u003c/li\u003e\n      \u003cli\u003e\u003ca href=\"https://www.github.com/ItsJokerZz/UOBWrapper\" target=\"_blank\"\u003eUOBWrapper\u003c/a\u003e\u003c/li\u003e\n    \u003c/ul\u003e\n  \u003c/details\u003e\n\u003c/details\u003e\n\n### Steps to Build\n1. **Ensure Prerequisites are Set Up:**\n   - Install **Unity Hub** and **Unity 2017.2.0p1** (or a compatible version).\n   - Set up the **PS4 SDK 4.50+** with the matching Unity integration.\n   - Download and move the [PS4 Fake PKG Tools 3.87](https://github.com/CyB1K/PS4-Fake-PKG-Tools-3.87) to the SDK.\n   - Download and install the [.NET 4.6 Developer Pack](https://www.dotnet.microsoft.com/en-us/download/dotnet-framework/net46).\n\n2. **Open the Project:**\n   - Launch **Unity Hub**, add your project, and open it.\n\n3. **Configure Build Settings:**\n   - In Unity, go to `File -\u003e Build Settings`.\n   - Click the `Player Settings` button.\n   - Expand the `Other Settings` section.\n     - Find `PS4 SDK Override` and set the correct SDK path.\n\n     **Note:** Necessary files are provided in the root of the source!\n\n   - Expand the `Publishing Settings` section.\n     - Set the paths for the following:\n       - `Share File Param` under the `Package` section.\n      \n    - Under the `Title Voice Recognition Details` section.\n       - `pronunciation.xml` and `pronunciation.sig`\n\n**For more detailed guidance with images, check out [RetroGamer74's guide](https://github.com/RetroGamer74/HowToBuildWithUnityPS4FakePKG/blob/master/README.md).**\n\n## Troubleshooting Error Code `CE-36441-8`\nIf you encounter this error, follow these steps to resolve it:\n\n\u003e [!WARNING]  \n\u003e **THIS IS NOT A FIX OR RECOMMENDED BUT THIS CAN HELP AS A TEMPORARILY \u003cbr\u003e\n\u003e WORKAROUND UNTIL REAOLVED. PLEASE BE ADVISED AND REVERT THIS AFTER!**\n\n1. **Enable Debug Menu**:  \n   - Open the **GoldHEN** menu.  \n   - Navigate to **Debug Settings** and enable **Full Menu**.  \n\n2. **Configure NP Environment**:  \n   - Go to the PS4's settings.  \n   - Navigate to `Debug Settings \u003e PlayStation Network`.  \n   - Set **NP Environment** to `invalid`.\n\n3. **Restart the Console**.  \n\nThis 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.\n\n**I am planning on looking into an actual fix rather than a work-around for this issue. If you have any ideas, \u003cbr\u003e please make a pull-request \nof [UnityOrbisBridge](https://github.com/ItsJokerZz/UnityOrbisBridge) plugin and I'll gladly look into it and merge into the branch.**\n\n## Special Thanks\n- **Original App Creator**: [Bucanero](https://www.github.com/bucanero)\n- **Original PKGi Music**: [nobodo](https://www.github.com/nobodo)\n\n  ### Unity Sources:\n    - [RetroGamer74](https://www.github.com/RetroGamer74) \u0026 [Lapy055](https://www.github.com/Lapy055)\n\nA huge thank you to the following members of the [OOSDK Discord](https://www.discord.com/invite/GQr8ydn) for their support:\n- **[TheMagicalBlob](https://github.com/TheMagicalBlob)**, [LightningMods](https://github.com/LightningMods), [Al-Azif](https://github.com/Al-Azif), Da Puppeh, Kernel Panic, lainofthewired, and others.\n\nFor more credits, please check out [UnityOrbisBridge](https://www.github.com/ItsJokerZz/UnityOrbisBridge). If I've missed anyone, feel free to reach out. \u003cbr\u003e\u003cbr\u003e\nFor assistance, please leave an issue and/or join my community [Discord server](https://discord.com/invite/RjG4Whf) and I'll help you out.\n\n## License\nThis project is licensed under the GNU General Public License v2.0 - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitsjokerzz%2Ffpkgi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fitsjokerzz%2Ffpkgi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitsjokerzz%2Ffpkgi/lists"}