Toolbox for analyzing and editing pkg application files for psp,ps3, ps4 and ps5, includes the most useful functions you might need.
| 1 | # PKG Tool Box |
| 2 | []() |
| 3 | -- |
| 4 | ## Description |
| 5 | PkgToolBox is a tool for manipulating PS4 PKG files. It allows you to extract, inject, modify, and obtain information about PKG files. |
| 6 | |
| 7 | ## ☕ Support PkgToolBox Development |
| 8 | |
| 9 | PkgToolBox is actively developed and maintained over time. |
| 10 | If you find this tool useful and want to support its continued development, you can buy me a coffee on Ko-fi. |
| 11 | |
| 12 | [](https://ko-fi.com/seregon) |
| 13 | |
| 14 | |
| 15 | ## 🤝 Contributions Welcome! |
| 16 | |
| 17 | **Contributions to the development are welcome!** If you have any ideas 💡 on how to improve the code, feel free to: |
| 18 | |
| 19 | - ✉️ Message me privately on [X (Twitter)](https://twitter.com/SeregonWar) |
| 20 | - 🔧 Open a [Pull Request](https://github.com/) |
| 21 | - 🐛 Report an issue through [Issues](https://github.com/) |
| 22 | |
| 23 | Currently, I am the only developer 👨💻 and handling all the work can be challenging. Any support is greatly appreciated! 🙌 |
| 24 | |
| 25 | |
| 26 | |
| 27 | ## Contributions |
| 28 | - **[Sinajet](https://github.com/sinajet/)**: Creator of **[PS5-Game-Info](https://github.com/sinajet/PS5-Game-Info)**, used in the program to read `eboot.bin` packages from `.pkg` files and recognize whether they are fpkg or not. |
| 29 | - **[HoppersPS4](https://github.com/HoppersPS4)**: Creator of c++ version [Waste_Ur_Time](https://github.com/HoppersPS4/Waste_Ur_Time) rewritten and implemented in PS4_Passcode_Bruteforcer.py module. |
| 30 | |
| 31 | If I forgot to add anyone below, please let me know on [X](https://x.com/SeregonWar)! |
| 32 | ## Features |
| 33 | - **Information**: Obtain detailed information about a PKG file. |
| 34 | - **File Explorer**: Navigate and manage files within the PKG using an integrated file explorer. |
| 35 | - **Hex Reader**: View and edit files in hexadecimal format. |
| 36 | - **Text Reader**: View and edit text files. |
| 37 | - **Delete**: Delete files from the PKG. |
| 38 | - **Trophy Management**: Load, unpack, read, and manage trophy files. |
| 39 | - **Trophy Creator**: Create new trophy files for games, customizing icons, descriptions, and achievements based on specific game requirements or user preferences. |
| 40 | - **Wallpapers**: Explore, extract, and modify wallpapers included in the PKG, allowing for the customization of background images used in the system or game. |
| 41 | - **Passcode Bruteforce**: Perform brute force attacks on passcodes included in the PKG, enabling the recovery or access to protected files within the package. |
| 42 | - **Integration with OpenOrbis**: Utilize `orbis-pub-cmd.exe` for advanced PKG manipulation. |
| 43 | |
| 44 | ## Requirements |
| 45 | - Python 3.13+ |
| 46 | - PyQt5 |
| 47 | - pyinstaller (use only pyinstaller, tools like cx_freeze will compromise the proper functioning of the project) |
| 48 | - `orbis-pub-cmd.exe` (included in the OpenOrbis toolchain) |
| 49 | |
| 50 | ## Installation |
| 51 | 1. Clone the repository: |
| 52 | ```sh |
| 53 | git clone https://github.com/seregonwar/PkgToolBox.git |
| 54 | cd PkgToolBox |
| 55 | ``` |
| 56 | |
| 57 | 2. Install the dependencies: |
| 58 | ```sh |
| 59 | pip install -r requirements.txt |
| 60 | ``` |
| 61 | |
| 62 | ## Usage |
| 63 | 1. Run the application: |
| 64 | ```sh |
| 65 | python main.py |
| 66 | ``` |
| 67 | |
| 68 | 2. Use the GUI to interact with PKG files: |
| 69 | - **Browse**: Select a PKG file to work with. |
| 70 | - **Extract**: Extract specific files from the PKG. |
| 71 | - **Inject**: Inject new data into the PKG. |
| 72 | - **Modify**: Modify the header of the PKG. |
| 73 | - **Dump**: Perform a complete dump of the PKG contents. |
| 74 | - **Info**: Obtain detailed information about the PKG. |
| 75 | - **File Explorer**: Navigate and manage files within the PKG. |
| 76 | - **Hex Reader**: View and edit files in hexadecimal format. |
| 77 | - **Text Reader**: View and edit text files. |
| 78 | - **Delete**: Delete files from the PKG. |
| 79 | - **Trophy Management**: Load, read, and manage trophy files. |
| 80 | |
| 81 | ## Roadmap |
| 82 | |
| 83 | ### Completed |
| 84 | - **PKG File Navigation** |
| 85 | - [x] Addition of an advanced directory file explorer to navigate internally within PKG files. |
| 86 | - [x] Advanced reading of information. |
| 87 | - [x] Improvement in the analysis of values in hex format. |
| 88 | - [x] PS5 PKG file support. |
| 89 | - [x] Full support for PS3 PKG files, retail and debug are supported. |
| 90 | - **Trophy Support** |
| 91 | - [x] Full support for `.trp` trophy files (PS4). |
| 92 | - [x] Full support for `.ucp` trophy files (PS5). |
| 93 | - **Stability** |
| 94 | - [x] Increased program stability. |
| 95 | - [x] Improved error handling. |
| 96 | - **General Improvements** |
| 97 | - [x] Various improvements and bug fixes. |
| 98 | ### In Progress / Planned |
| 99 | - **PKG Support** |
| 100 | - [ ] Full support for PS5 PKG files. |
| 101 | - [ ] Advanced PKG file splitting. |
| 102 | - [ ] Fpkg updates. |
| 103 | - [ ] Implementation of PKGToolBox directly on PS4 and PS5 systems. |
| 104 | - **DLC Injection** |
| 105 | - [ ] Implementation of the inject section for loading DLC directly into PKG packages. |
| 106 | - **Multi-platform Compatibility** |
| 107 | - [ ] Implementation of the project on other platforms (e.g., Linux, macOS, etc.). |
| 108 | - **File Decryption** |
| 109 | - [ ] Decryption of `.ESFM` files. |
| 110 | |
| 111 | ## GUI |
| 112 | <img width="1340" height="944" alt="Screenshot 2025-12-17 alle 13 44 38" src="https://github.com/user-attachments/assets/890e9463-7241-4ad2-a5e7-2c1b1cc5c9d9" /> |
| 113 | |
| 114 | |
| 115 |