BREAKALLERY (PS5 Capture Hub)

View, stream, and download jailbroken PS5 screenshots and gameplay clips on any phone, tablet, PC, or TV.

---

Why Breakallery?

When you jailbreak your PS5, access to PlayStation Network (PSN) is disabled, meaning Sony's official PlayStation App can no longer sync or upload your game captures.

Breakallery bridges this gap:

• Zero PS5 Installation Required: Connects to the FTP server already built into jailbreak payloads (etaHEN, ftps5, Itemzflow, GoldHEN).
• Instant Video Streaming: Uses an HTTP Byte-Range Proxy (206 Partial Content). You can scrub through 4K 60fps clips on your phone immediately without downloading multi-gigabyte files first.
• Game Metadata & Official Covers: Automatically extracts official 512×512 game cover art (icon0.png) and title names from /user/appmeta/<TITLE_ID>/.
• Mobile-First PWA: Open it on iOS or Android and tap "Add to Home Screen" for a full-screen, native PlayStation companion app experience.
• Optional Background Auto-Sync: Automatically downloads new captures whenever your PS5 is powered on, letting you view your media gallery even when the console is off.
• Instant Phone Pairing: Displays a QR code in the terminal and web interface—point your phone camera and tap to launch.

---

Quick Start

1. Requirements

• Node.js v18+ (tested on Node.js v20+)
• A jailbroken PS5 with FTP enabled (etaHEN default is port 1337, or 2121 / 21)
• Both your PC and phone/tablet connected to the same Wi-Fi or LAN

2. Start Breakallery

In your terminal, run:

npm start

3. Open on Any Device

• On your PC: Open http://localhost:5050
• On your Phone / Tablet: Scan the QR code printed in the terminal or navigate to http://<your-pc-ip>:5050

---

Configuration & PS5 Setup

Click the Settings (⚙️) icon in the top navigation bar:

1. PS5 IP Address: Enter your PS5's local IP (e.g., 192.168.100.25). You can find this on your PS5 in Settings > Network > Connection Status > View Connection Status.
2. Port:
   • 2121 (Default for etaHEN, ftps5, GoldHEN)
   • 1337 (Alternative etaHEN port)
   • 21 (Standard FTP daemon)
3. Test Connection: Click the button to test if your PS5 FTP server is reachable.
4. Auto-Sync (Optional): Enable this to keep an offline backup of your captures in the Captures/ folder on your PC with game subfolders.
5. System Tray: Toggle whether closing the app minimizes to the system tray or exits completely.

For a full list of changes across releases, check out CHANGELOG.md.

---

How It Works Internally

[ PS5 (Jailbroken) ]
   └── FTP Server (port 1337 / 2121)
         │
         ├── /user/av_contents/photo/<TITLE_ID>/   (Screenshots & thumbnails)
         ├── /user/av_contents/video/<TITLE_ID>/   (Clips & thumbnails)
         └── /user/appmeta/<TITLE_ID>/             (icon0.png cover art & param.json)
         │
         ▼
[ Breakallery Bridge Server ]
   ├── Reads directory trees & caches metadata
   ├── Caches thumbnails locally on SSD (.cache/thumbnails/)
   ├── HTTP Range Proxy (translates HTTP range requests to FTP offsets for instant scrubbing)
   └── Optional Auto-Sync Daemon
         │
         ▼
[ Client Devices (Web / PWA) ]
   ├── iPhone / Android Safari & Chrome (Add to Home Screen)
   ├── Desktop Browser
   └── Smart TV / iPad

---

Desktop Application (.exe)

Breakallery is fully packaged as a native Windows desktop app powered by Electron:

• Standalone Portable Executable: dist-electron/Breakallery-Portable.exe (run directly from anywhere with zero installation).
• System Tray Minimization: Closing the window minimizes Breakallery to the Windows system tray. It stays active in the background, streaming captures to your phone without cluttering your desktop!
• Tray Quick Actions: Right-click the tray icon to copy your phone's connection link, trigger a PS5 sync, or restore the window.

Running & Building the Desktop App:

• Run in Dev Mode: npm run app
• Build Single-File Portable EXE: npm run dist:portable
• Build Unpacked Windows App: npm run dist:dir

---

Development & Web Server Commands

• Run Web Server Only: npm start
• Run Frontend Dev Server: npm run dev:client
• Build Frontend for Production: npm run build

---

Adding to Phone Home Screen (PWA)

1. On iPhone (Safari): Tap the Share button (box with arrow) ➔ Tap "Add to Home Screen".
2. On Android (Chrome): Tap the three dots menu ➔ Tap "Add to Home Screen" or "Install App".

Breakallery will now launch as a standalone, full-screen companion app with its custom PlayStation icon!