Platform: Windows, macOS, Linux (Java 17+) & Android
Target Systems: PlayStation 4 (GoldHEN, flatz RPI) & PlayStation 5 (etaHEN DPI)
Current Version: COMING SOON

1. Executive Summary & Review

PlayBridge is an all-in-one workstation application designed to bridge personal computers (and Android mobile devices) with jailbroken PlayStation 4 and PlayStation 5 consoles over a Local Area Network (LAN).

Unlike legacy tools that rely on cumbersome command-line scripts or slow FTP transfers that require double the console storage, PlayBridge features an RFC 9110-compliant high-speed HTTP Range streaming proxy, allowing consoles to download, verify, and install multi-gigabyte .pkg files directly on the fly (1x storage requirement).

Review Highlights

Zero Double-Storage Penalty: Stream games directly from PC storage without copying .pkg files to /data/pkg/ first.
Live Installation Progress (%): Real-time integration with Sony’s BGFT (Background File Transfer) engine provides second-by-second completion percentages and ETA countdowns.
Split PKG Assembly on the Fly: Seamlessly merges split parts (.pkg.0, .pkg.1, etc.) into a continuous virtual stream without taking up extra hard drive space.
Direct NAS / Cloud Streaming: Stream packages directly from Network-Attached Storage (SMB, FTP, WebDAV) without downloading them to your PC first.
All-in-One Console Tooling: Built-in shadPS4 game dumper, GoldHEN cheat synchronizer, BinLoader payload injector, and remote FTP file manager.

2. Core Feature Breakdown

2.1. PKG Streamer & Smart Multi-Protocol Deployer (Tab 0)

Single & Batch Package Deployment: Drag and drop one or dozens of .pkg files directly into the window. PlayBridge inspects headers, extracts game title metadata, and stages them into an automated deployment pipeline.
Split PKG Automatic Stitching: If a package is split across multiple files (e.g., FAT32 limitations from USB drives), PlayBridge detects the sequence and streams them as one unified package to the console.
Multi-Protocol Engine with Intelligent Routing:
- RPI HTTP Stream (:12800 / :12801): The gold standard for GoldHEN and flatz Remote Package Installer. Installs games directly with live progress feedback.
- PS5 etaHEN DPI Socket (:9045): Direct Packet Injection tailored for PlayStation 5 consoles running etaHEN, streaming games in the background without needing a dedicated app open.
- GoldHEN FTP Push (:2121): Direct FTP upload to /data/pkg/ for legacy offline installation via the GoldHEN Package Installer menu.
Live Percentage & Interactive Cancellation:
- Displays real-time %, transferred bytes, and time remaining directly on the streamer action bar.
- An interactive "Cancel Installation (XX%)" button halts background threads, shuts down the local proxy, and sends an immediate /api/stop_task command to the PlayStation so the console aborts cleanly without errors.

+-----------------------------------------------------------------------------------+
|  [Select PKG Files]  [Clear Selection]               [Cancel Installation (45.2%)]|
+-----------------------------------------------------------------------------------+
|  Installing on console: 45.2% (775.20 MB / 1.72 GB) • 35s left                     |
|  [==========================----------------------------------------------------] |
+-----------------------------------------------------------------------------------+

2.2. Remote Storage & NAS Direct Streaming

PlayBridge eliminates the need to download large game archives to your local PC disk before installing them onto your console:

Supported Protocols: SMB Windows Network Shares, Remote FTP Servers, and WebDAV / HTTP Range servers.
Zero-Copy Piping: When you stage a remote package from your NAS, PlayBridge proxies the HTTP range requests from the PlayStation directly to your NAS. Your PC acts as a high-speed router with near-zero disk wear.

2.3. Homebrew Store & Community Feeds (Tab 1)

Built-In Homebrew Catalog: Browse, search, and filter verified homebrew applications, emulators, utilities, and community tools.
Categorized Discovery: Instant filtering across Games, Emulators, Utilities, and Media.
One-Click Remote Install: Click "Download & Install" to automatically pull the package from the internet and stream it directly to your console in a single step.
Custom URL & GitHub Release Resolver: Paste any direct package link or GitHub repository release URL to deploy custom homebrew without manual extraction.

2.4. Universal Queue & Notification Center (Tab 2)

Full Pipeline Transparency: Track every staged, streaming, uploading, or completed task in a centralized queue.
Detailed Task Cards:
- Game title and source filename.
- Dynamic status badge: INSTALLING 45.2%, STREAMING 78.0%, COMPLETED (100%), UPLOADING, or PAUSED.
- Visual progress bar matching console download phases.
- Byte counter (775 MB / 1.72 GB), transfer speed (MB/s), and remaining ETA.
OS Desktop & Audio Notifications: Native desktop toast alerts inform you when packages are queued, when installations finish, or if network disruptions occur.

2.5. shadPS4 Decrypted Game Dumper (Tab 3)

1-Click Game Extraction: Connects to your console’s file system while a game is running to extract decrypted executables, patch files, and assets directly to your PC.
Emulator-Ready: Generates directory structures compatible with the shadPS4 emulator for instant testing on PC.
Resumable Transfers: Auto-resumes interrupted file transfers without restarting multi-gigabyte dumps.

2.6. Cheats Synchronizer (Tab 4)

GoldHEN Cheat Database: Instant access to thousands of community cheats.
Title ID Search: Search by Game Title or Title ID (e.g., CUSA00123).
Instant Deployment: Uploads .json, .mc4, or .shn cheat definitions directly to /user/data/GoldHEN/cheats/ on the PlayStation.

2.7. Payload Injector (Tab 5)

GoldHEN BinLoader Port 9090: Stage and transmit .bin or .elf payloads directly to the GoldHEN BinLoader server.
Port Health Check: Displays a live indicator confirming whether Port 9090 is receptive before sending payloads.

2.8. Console Management & Hardware Utilities

Console Profile Manager: Save and quickly toggle between multiple PlayStation consoles (e.g., Living Room PS4, Bedroom PS5).
Auto Network Scanner: Probes your local subnet to automatically discover PlayStation consoles and identify open services (RPI :12800, RPI :12801, DPI :9045, FTP :2121, BinLoader :9090).
Wake-on-LAN (WoL): Power on or wake your console from Rest Mode by broadcasting magic packets to Ports 9 and 7.
Desktop Sleep Prevention (DesktopWakeLock): Automatically prevents your PC from entering sleep, screen timeout, or disk spindown mode during active game installations or dumps.
PS4 Temp Cache Cleaner: Frees up space on your console hard drive by clearing out abandoned temporary chunks in /user/app/ and /data/pkg/.

2.9. ⚡ Pro Tools Suite: Desktop Superpowers (Tab 7 - Desktop Exclusive)

The ⚡ Pro Tools Suite is an advanced engineering workstation built exclusively into PlayBridge Desktop. Leveraging unrestricted multi-core host processing, zero-copy socket streaming, and native desktop toolchains, Pro Tools transforms PlayBridge from a simple installer into an all-in-one console development, modding, and administrative powerhouse.

+---------------------------------------------------------------------------------------------------------+
| ⚡ Desktop Superpowers Suite  [DESKTOP EXCLUSIVE]              [CDN :8080 ACTIVE]  [● RPI Ready]        |
| Unrestricted multi-core processing, zero-copy HTTP streaming, and native desktop toolchains.            |
+---------------------------------------------------------------------------------------------------------+
| [Local CDN] [FPKG Repacker] [Deep Extractor] [Batch Swarm] [Telemetry] [VFS Modder] [Hex Workspace] ...|
+---------------------------------------------------------------------------------------------------------+

The suite includes 10 specialized superpower tools:

1. FPKG Repacker Engine (`FPKG_REPACKER`)

What it does: Automates the complete Fake PKG (FPKG) compilation pipeline from raw or dumped /app0 directories.
Key Capabilities:
- Auto-detects directory layouts, parses sce_sys/param.sfo, and auto-fills TITLE_ID and CONTENT_ID.
- Dynamically generates PlayStation .gp4 project XML descriptors with proper volume hierarchies and passcodes.
- Automates LibOrbisPkg / OrbisPubGen command execution via native ProcessBuilder.
- Integrated Streaming Terminal Log with real-time color-coded ANSI output (STDOUT, STDERR, INFO, SUCCESS, ERROR).
- Built-in Toolchain Manager that can automatically download, verify, and configure necessary compiler binaries in one click.

2. Firmware & Deep PKG Extractor (`PKG_EXTRACTOR`)

What it does: High-performance binary unpacker and inspector for PlayStation 4/5 .pkg (0x7F434E54 CNT) and PlayStation Update Packages (.pup / 0x53434555 SCEU).
Key Capabilities:
- Uses RandomAccessFile chunk parsing to inspect multi-gigabyte archives in milliseconds without extracting the full container to disk.
- Instant 1-click extraction of critical files: param.sfo, high-resolution icons (icon0.png, pic0.png, pic1.png), audio assets (snd0.at9), trophies (trophy00.trp), and license files (license.dat).
- Extracts raw firmware binaries from .pup files, including kernel.bin, system.img, recovery.img, and version.txt.
- Built-in Skia image previewer displays icon and splash art directly in the app.

3. Local LAN Store / Embedded CDN Server (`LOCAL_CDN`)

What it does: Converts your PC into a high-throughput, zero-copy HTTP streaming Content Delivery Network and homebrew repository.
Key Capabilities:
- Console Web Browser Portal: Console users can launch their PlayStation web browser and navigate to http://<PC_IP>:8080/ to browse their PC game library with box art and initiate installs directly from their TV.
- Dynamic Store Feeds: Generates compliant manifest.json and store.json feeds that integrate with console Homebrew Store apps.
- RFC 7233 HTTP 206 Byte-Range Streaming: Serves high-speed chunked streams directly to the console’s Background File Transfer (BGFT) engine with zero memory buffering.
- Recursive Library Crawler: Watches local game folders and subfolders to automatically index Title IDs, versions, categories, and cover art.

4. Gigabit Batch Swarm (`BATCH_SWARM`)

What it does: An unthrottled, multi-package mass deployment engine designed for library migrations and power users.
Key Capabilities:
- Drag and drop 50+ .pkg files at once.
- Leverages an uncapped Coroutine Channel on Dispatchers.IO to push packages to the console at line rate (exceeding 100 MB/s over Gigabit Ethernet).
- Full queue management: dynamic pause, resume, cancel, and per-item status indicators (QUEUED, DEPLOYING, COMPLETED, FAILED).
- Displays aggregate transferred gigabytes, live transfer bandwidth, and per-item progress bars.

5. Hardware Telemetry Dashboard (`TELEMETRY`)

What it does: Live console hardware monitor that tracks thermals, fan curves, memory, and CPU metrics via GoldHEN REST API and debug sockets.
Key Capabilities:
- Real-Time Visual Gauges & Rolling Charts: Second-by-second graphs tracking APU / SOC Temperature (°C), Memory Temperature (°C), Fan Speed (RPM & %), System RAM Usage (MB/GB), and CPU Load (%).
- Overheat Alerting: Visual warning indicators trigger when APU temperatures exceed safe thresholds (e.g., > 75°C), enabling users to test custom fan curves and thermal paste conditions.
- Built-in Demo Mode: Allows testing the dashboard with simulated hardware load curves even when disconnected from the console.

6. Real-Time VFS Asset Injector (`VFS_MODDER`)

What it does: Live game modding and asset hot-swapping engine utilizing Java NIO WatchService.
Key Capabilities:
- Monitors a local workspace directory on your PC.
- Whenever you modify or save a texture, sound file, translation string, or game script, the engine instantly uploads it via FTP directly into /mnt/sandbox/pfsmnt/<TitleID>-app0/ or /user/app/ on the running console.
- Eliminates the Repack Loop: Allows mod developers to see their changes in-game immediately without spending 20 minutes rebuilding and reinstalling massive 40+ GB packages!

7. Integrated Hex Workspace (`HEX_WORKSPACE`)

What it does: Built-in 16-byte aligned binary viewer and hex editor tailored for Apollo save files, decrypted game binaries (eboot.bin), and raw memory dumps.
Key Capabilities:
- Dual-column layout displaying hex offsets, byte values, and ASCII characters.
- In-Place Byte Editing: Click any byte to modify its value directly in the grid.
- Pattern search for hexadecimal byte sequences or plaintext strings.
- Save modifications back to disk with automatic checksum validation and file size verification.

8. Ultimate PKG Merger & Super-PKG Synthesizer (`PKG_MERGER`)

What it does: Synthesizes a Base Game .pkg, an Update Patch .pkg, and multiple DLC Add-On .pkg files into a single unified "Super-PKG".
Key Capabilities:
- Stages the base package, overlays the update patch over /app0, unpacks DLC contents, and merges the filesystem hierarchies.
- Generates a consolidated .gp4 descriptor and compiles a single monolithic package.
- Console Convenience: Eliminates the need to install a base game, update patch, and 15 DLCs separately—installing the resulting Super-PKG gives you the complete game in one single step!
- Also merges physical FAT32 split packages (.pkg.0, .pkg.1, etc.) into a unified file.

9. Console FTP File Manager & Live Config Editor (`FTP_FILE_MANAGER`)

What it does: Dual-pane remote file manager engineered specifically for PlayStation system partitions (/data/, /user/app/, /system/, /mnt/usb0/, /mnt/usb1/, GoldHEN configs).
Key Capabilities:
- Built-In Live Text & Config Editor: Double-click .ini, .json, .xml, .cfg, .log, .sh, or .conf files to open an inline editor and save changes directly back to the console without manually downloading and re-uploading.
- High-speed file uploads, downloads, deletions, directory creation, and renaming.
- Real-time formatted file size calculations and directory navigation breadcrumbs.

10. Payload Scratchpad & Compiler (`PAYLOAD_IDE`)

What it does: An integrated C/ASM payload scratchpad, compiler interface, and 1-click Port 9090 BinLoader injector.
Key Capabilities:
- Lightweight C/C++ editor with code completion and bracket matching.
- Targets Port 9090 BinLoader for instant socket injection directly upon compilation.
- Pre-loaded payload templates for common tasks: GoldHEN loader, Linux payloads, FTP server triggers, and UART debug utilities.

3. Quick Start Guide for End Users

Step 1: Console Preparation

Ensure your PS4 or PS5 is connected to the same local network (Wi-Fi or Ethernet) as your PC.
For PS4: Ensure GoldHEN is loaded. Open the Remote Package Installer application (or enable RPI in GoldHEN settings).
For PS5: Ensure etaHEN is active with DPI enabled (Port 9045).

Step 2: Connect PlayBridge

Launch PlayBridge Desktop.
Click "Auto-Scan Local Network" in the left sidebar, or type your console's IP address into the Console IP Address field.
Click "Test Connection". The status badge will change to a green "ONLINE" indicator with verified ports.

Step 3: Stream and Install a Game

On the PKG Streamer tab, drag and drop your .pkg file(s) into the staging area.
Verify the selected delivery method (default is Auto-Detect).
Click "Send to Console".
Watch the progress bar: PlayBridge will launch the stream and display live installation percentages (%) and time remaining until complete.

4. Delivery Method Comparison Matrix

Method	Target System	Console Storage Required	Speed / Overhead	Live Progress (%)
RPI HTTP Stream (:12800 / :12801)	PS4 (GoldHEN / flatz)	1x (No duplicate PKG)	⚡ High-Speed (LAN Line Rate)	Yes (Sony BGFT % + ETA)
PS5 etaHEN DPI (:9045)	PS5 (etaHEN)	1x (No duplicate PKG)	⚡ Ultra High-Speed	Yes (Socket byte counter)
GoldHEN FTP (:2121)	PS4 (GoldHEN)	2x (Copies PKG to disk first)	🐢 Slower (Raw file copy)	Yes (FTP byte tracker)

5. Troubleshooting & Best Practices

Console Rejects Stream / Socket Timeout:
- Verify that the RPI homebrew app is open on your PS4, or that GoldHEN RPI service is running.
- Check that your Windows Firewall allows incoming connections on port 8080 (PlayBridge proxy port).
Switching Packages During Deployment:
- If you need to stop an install and send a different game, simply click "Cancel Installation" or "Clear Selection". PlayBridge will safely terminate the console task and cleanly initialize the proxy for the new game.
Maximizing Speeds:
- For games larger than 20 GB, connect both your PC and console via Gigabit Ethernet cables rather than 2.4 GHz Wi-Fi for transfer speeds exceeding 90–110 MB/s.

README.md Unescape Escape

PlayBridge Desktop: End-User Feature Guide & Review (COMING SOON)