steam-frame/rawblue33--PlayBridge-Desktop
1
0 Fork 0
mirror of https://github.com/rawblue33/PlayBridge-Desktop.git synced 2026-10-28 20:26:44 +01:00
Code Issues Packages Projects Releases Wiki Activity
Files
main
rawblue33--PlayBridge-Desktop/README.md
T
Ari fb3a954aca Update README.md
2026-10-20 02:40:43 +03:00

18 KiB
Raw Permalink Blame History

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

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.

USDT BEP20 Donation QR Code

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.

USDT BEP20 Donation QR Code

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.

USDT BEP20 Donation QR Code

3. Quick Start Guide for End Users

Step 1: Console Preparation

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

Step 2: Connect PlayBridge

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

Step 3: Stream and Install a Game

  1. On the PKG Streamer tab, drag and drop your .pkg file(s) into the staging area.
  2. Verify the selected delivery method (default is Auto-Detect).
  3. Click "Send to Console".
  4. 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.
Reference in new issue View Git Blame Copy Permalink