Prosperous User Manual & GUI Guide

Welcome to the Prosperous user manual.

This guide provides complete, step-by-step operational instructions for both the pros command-line interface and the pros-gui desktop application, designed for homebrew operators, game testers, and developers managing physical console hardware.

If you are an AI coding agent or systems architect seeking the low-level socket protocol state machines, internal transport crates, or decision records, see the Technical Reference and DECISIONS.md instead.

Table of Contents

  1. Quickstart: Connecting to Your Target
  2. CLI Command Reference (pros)
  3. pros-gui Desktop Window Walkthrough
  4. Troubleshooting & Network Diagnostics

1. Quickstart: Connecting to Your Target

Prosperous stores registrations locally under %APPDATA%\OOPS\prosperous\ (on Windows) or ~/.config/oops/prosperous/ (on Linux).

1. Register a Target Console

pros register 192.168.1.211 --name living-room

2. Verify Available Targets

pros list

2. CLI Command Reference (pros)

Checking Target Health (pros check)

Whenever communication is uncertain, run pros check. It tests all 5 standard services:

pros check --name living-room
Target: living-room (192.168.1.211)
  elfldr  [9021] : UP (12ms)   - Direct memory payload execution
  ftpsrv  [2121] : UP (8ms)    - Remote filesystem access & staging
  klogsrv [3232] : UP (5ms)    - Kernel log stream
  shsrv   [2323] : UP (14ms)   - Direct remote command shell
  pldmgr  [8084] : UP (9ms)    - Resident payload management
Status: READY

Staging & Transferring Files (pros restore)

Upload titles, packages, or raw assets to the target's internal storage via FTP:

# Upload a complete game title folder into /data/homebrew/
pros restore build/title/GLCB00001 /data/homebrew/GLCB00001

# Copy a single package file into /data/pkg/
pros restore build/game.pkg /data/pkg/game.pkg

Launching & Supervising Titles (pros launch)

Launch an installed or staged title by its Title ID:

pros launch GLCB00001

To close a running title:

pros close GLCB00001

Streaming Kernel Logs (pros logs)

Stream live kernel and application telemetry (klog) directly to your terminal:

# Stream continuously to stdout
pros logs

# Stream and simultaneously pipe to a local file
pros logs | tee-object -filepath ps5-session.log

Executing Shell Commands (pros sh)

Execute remote commands directly on the target without deploying an ELF:

pros sh "ls -la /data/homebrew"

3. pros-gui Desktop Window Walkthrough

Launch the desktop interface with:

pros-gui

A. Target Browser & Health Matrix

The main dashboard provides real-time reachability monitoring for all registered hardware:

+-------------------------------------------------------------------------------+
|  Prosperous Target Browser                                       [_][O][X]    |
+-------------------------------------------------------------------------------+
| Targets           | Status | elfldr | ftpsrv | klog | shsrv | pldmgr | Action |
|-------------------+--------+--------+--------+------+-------+--------+--------|
| (*) living-room   | ONLINE |   OK   |   OK   |  OK  |  OK   |   OK   | [Open] |
| ( ) lab-ps5-pro   | OFFLINE|   --   |   --   |  --  |  --   |   --   | [Poll] |
+-------------------------------------------------------------------------------+
| Selected Target: living-room (192.168.1.211)                                  |
| OS: Prospero FW 12.40 | Storage: 412.8 GiB Free                               |
| [ + Register New Target ]   [ Refresh Health ]   [ Open Remote Shell ]        |
+-------------------------------------------------------------------------------+

Prosperous Target Browser UI (Screenshot placeholder: Target Browser & Health Matrix)

B. Live Kernel Telemetry Streamer

Stream, filter, and search real-time system logs with zero buffering:

+-------------------------------------------------------------------------------+
|  Console Kernel Log (living-room)                                [_][O][X]    |
+-------------------------------------------------------------------------------+
| Filter: [ sceAgc                             ]  [Auto-Scroll: ON] [Clear]     |
|-------------------------------------------------------------------------------|
| 118: <118>[SceSystemStateMgr] Power Mode Change: BIG_APP                      |
| 119: <118>[SceLncService] SetControllerFocus(0x00006018)                      |
| 120: <118>[AvControl] entry process(appid:0x6018 pid:0xbf)                    |
| 121: [OOPS-GL] creating AGC universal queue...                                |
| 122: [OOPS-GL] sceAgcDriverCreateQueue rc: 0x0                                |
| 123: [OOPS-GL] hardware AGC RDNA2 pipeline initialized successfully           |
| 124: [OOPS-GL] flush-words: 0x39b submit-rc: 0x0 fence-hit: 0x1              |
+-------------------------------------------------------------------------------+
| [Pause Stream]  [Save Log to File...]  [Export Filtered View]                 |
+-------------------------------------------------------------------------------+

Prosperous Kernel Log Streamer UI (Screenshot placeholder: Live Kernel Telemetry Streamer)

C. Remote File Explorer & Title Stager

Drag-and-drop file browser connected directly to the console's /data/ and /user/ partitions:

+-------------------------------------------------------------------------------+
|  Remote Storage Browser - living-room                            [_][O][X]    |
+-------------------------------------------------------------------------------+
| Path: /data/homebrew/GLCB00001/                                               |
|-------------------------------------------------------------------------------|
| Name                 | Size      | Type      | Permissions | Modified         |
|----------------------+-----------+-----------+-------------+------------------|
| [..]                 | --        | Directory | drwxr-xr-x  | 2026-09-14 10:00 |
| eboot.bin            | 412.5 KiB | Executable| -rwxr-xr-x  | 2026-09-14 11:30 |
| sce_module/          | --        | Directory | drwxr-xr-x  | 2026-09-14 11:30 |
|   libc.prx           | 128.0 KiB | Shared Lib| -rwxr-xr-x  | 2026-09-14 11:30 |
| sce_sys/             | --        | Directory | drwxr-xr-x  | 2026-09-14 11:30 |
|   param.json         | 1.2 KiB   | Metadata  | -rw-r--r--  | 2026-09-14 11:30 |
|   icon0.png          | 64.0 KiB  | Image     | -rw-r--r--  | 2026-09-14 11:30 |
+-------------------------------------------------------------------------------+
| [ Upload Directory... ]  [ Download Selected ]  [ Delete ]  [ Launch Title ]  |
+-------------------------------------------------------------------------------+

Prosperous File Explorer UI (Screenshot placeholder: Remote File Explorer)

D. Title Launcher & Process Supervisor

View currently running applications, active PIDs, and kill or restart titles with one click:

+-------------------------------------------------------------------------------+
|  Title Supervisor (living-room)                                  [_][O][X]    |
+-------------------------------------------------------------------------------+
| Running Titles:                                                               |
|   * GLCB00001 - "GL-Cube 3D Demo" (AppID: 0x6018, PID: 191) [RUNNING]        |
|                                                                               |
| Staged Titles (/data/homebrew):                                               |
|   [Launch] GLCB00001  - GL-Cube 3D Demo (v1.00)                               |
|   [Launch] OBSC00001  - obSCEne Conformance Suite (v2.4)                       |
|   [Launch] WIPE00001  - WipEout Model Viewer (v1.00)                          |
+-------------------------------------------------------------------------------+
| [ Terminate Running Title (SIGKILL) ]   [ Relaunch (F5) ]                     |
+-------------------------------------------------------------------------------+

Prosperous Title Supervisor UI (Screenshot placeholder: Title Supervisor UI)

4. Troubleshooting & Network Diagnostics

Target Unreachable / Timeout

  1. Verify host and PS5 are on the same subnet (e.g. 192.168.1.x).
  2. Verify Wi-Fi / Ethernet connection status on the console settings.
  3. Test connectivity with ping 192.168.1.211.

"Directory creation refused: 226"

"elfldr down (Connection refused: 9021)"