PS5 Image Converter v1.0.1

Changelog: v1.0.1

New Features

• Windows Platform Support: Added the official Windows version of the application. Previously compatible only with Linux, the tool now provides a fully portable, native standalone executable for Windows 7 64-bit and newer with zero extra setup required. Windows version is in Beta as I do not use the OS. Report any issues or bugs at https://x.com/KryoMod

• Context-Aware Path Management: The application now intelligently remembers workflow. The Source path automatically defaults one level up from the last selected file or folder, defaulting it back to the main game folder rather than the last source game folder or image file. The "Destination" path remains "sticky," ensuring the output folder stays consistent across sessions.

• Persistent Configuration: Added automatic path saving. The application now remembers the last-used source and destination directories upon restarting using a local hidden config file (~/.ps5_converter_config).

• Unpack to Game Folder: A dedicated utility for automated extraction that creates a dedicated sub-folder named after the source file, keeping the output directory organized.

• Intelligent Inspect & Unpack: The Inspect tool has been overhauled to accurately detect and report the source type of .ffpfsc image files (raw game dump vs. exFAT container).

• Enhanced Progress UI: Integrated an indeterminate progress bar to provide visual feedback during operations.

Improvements & Fixes

• Dynamic UI Layout: The Destination input and "Browse" button dynamically hide when in "Inspect" mode, preventing redundant inputs and user confusion.

• Robust Configuration: Fixed an issue where the application would revert to the script directory if the last-used source file was moved or deleted.

• Intelligent File Naming: Improved path handling ensures output images are correctly placed within the chosen destination directory.

• Stability Enhancements: Optimized internal task handling and sub-process execution for more reliable long-running operations.

• Backend Refactoring: Consolidated logic into a maintainable class structure and removed deprecated error handling patterns for a cleaner, more stable execution flow.

• Enhanced Console Logging: Real-time logging now captures and displays standard error and stdout directly from the mkpfs CLI, providing much better visibility into the background process.

PS5-Image-Converter v1.0.0 Beta

PS5 Image Converter v1.0.0

This version is broken. Users should download the latest version which is fully tested and fully functional.

This is the initial official release of PS5 Image Converter, a graphical user interface (GUI) designed for the PlayStation 5 homebrew community to simplify file compression/decompression operations. This utility completely automates image handling for pipelines like ShadowMountPlus by acting as a front-end wrapper for the mkpfs engine.

• GUI Frontend Wrapper Created by: chuey_316
• Original Core CLI Engine Created by: Renan Barreto

---

🌟 Key Features

• Visual Mode Selection: Dynamically switch between packing files, packing folders (compressed/uncompressed), inspecting metadata, and unpacking image formats.
• Automatic Multi-Step Packing: Automates the exact 2-step pipeline (pack folder -> pack file) required to make compressed .ffpfsc images fully playable on the console without extra steps.
• Linux Dark Mode Stability: Pre-configured system layout color mappings that prevent text visibility bugs on dark themes (like Linux Mint).
• Space Safety Safeguard: Automatically handles folder and file paths containing spaces perfectly without path truncation or execution errors.
• Real-time Console Tracking: An integrated live terminal log that tracks compression benchmarks smoothly in real time.

---

🚀 How to Install & Run

For Linux Users:

1. Download and extract the PS5_Image_Converter.zip package.
2. Ensure you have the required system dependencies installed (see Requirements below).
3. Open the extracted folder, right-click an empty space, and select "Open in Terminal".
4. Grant execution permissions to the launcher script by running this exact command:

chmod +x "PS5 Image Converter"

5. Close the terminal. You can now launch the application anytime by double-clicking the PS5 Image Converter.sh file.

For Windows Users: (COMING SOON)

1. Download and extract the PS5_Image_Converter.zip package.
2. Double-click the mkpfs_launcher executable inside the folder to run the program natively. (Fully portable, no command line required).

---

📋 Requirements

• Windows Support: Natively compatible with Windows 7 64-bit and all newer versions (Windows 10/11) with zero extra setup.

• Linux Support: Requires Python 3.8+ with python3-tk extensions installed.

• Linux Dialog Dependency: Your Linux distribution must have zenity installed for the file browser popups to function. On Ubuntu/Debian/Mint, install it via terminal using:

  sudo apt install zenity python3-tk

---

📄 License & Credits

Free to use, and share. All rights reserved. Original mkpfs CLI tool rights and core engine functionality belong entirely to their respective author, Renan Barreto.