# nosferatuzodd7/orbislink architecture

> Architecture diagram of the GitHub repository nosferatuzodd7/orbislink, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nosferatuzodd7/orbislink
- Repository: https://github.com/nosferatuzodd7/orbislink

## Overview

OrbisLink is a desktop companion for jailbroken PlayStation consoles. A user selects or discovers a console, then uses the app’s controllers to browse files, install packages, manage games and saves, or start Remote Play. The graph separates UI orchestration, console services, game/package workflows, library/store features, and streaming. README-documented capabilities are retained even where their implementation was not sampled; edges for those features cite the README, and unsampled internals are not inferred.

Main entry points: [`src/orbislink/qt/app_controller.cpp`](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/qt/app_controller.cpp) (App controller), [`src/orbislink/qt/games_controller.cpp`](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/qt/games_controller.cpp) (Games controller), [`src/orbislink/ftp/ftp_client.cpp`](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/ftp/ftp_client.cpp) (FTP client), [`src/orbislink/console/console_manager.cpp`](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/console/console_manager.cpp) (Console manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop app"]
  node_app["App controller<br/>[app_controller.cpp]"]
  node_queue["Job queue<br/>[install_queue.cpp]"]
  node_settings[("Settings<br/>[settings_store.cpp]")]
end

subgraph group_connect["Console connectivity"]
  node_console["Console manager"]
  node_discovery["Console discovery<br/>[discovery.cpp]"]
  node_lan["LAN scanning<br/>[lan_scan.h]"]
  node_ftp["FTP client<br/>[ftp_client.cpp]"]
  node_installer["Package installer API<br/>[rpi_client.cpp]"]
  node_http["HTTP client<br/>[http_client.cpp]"]
end

subgraph group_games["Games and packages"]
  node_games["Games controller"]
  node_disc["Classic disc converter"]
  node_pkg["Package inspector<br/>[pkg_inspector.h]"]
  node_organizer["Package organizer<br/>[pkg_organizer.cpp]"]
end

subgraph group_library["Library and services"]
  node_library["Console game library<br/>[console_library.h]"]
  node_shelf["Games shelf"]
  node_store["Homebrew store"]
  node_saves[("Save vault<br/>[save_vault.cpp]")]
  node_payloads["Payload manager"]
  node_cheats["Game cheats<br/>[cheats.cpp]"]
end

subgraph group_stream["Remote Play"]
  node_stream_ui["Stream controller"]
  node_stream_session["Streaming session<br/>[session.cpp]"]
end

node_user(("Desktop user"))
node_console_actor(("PS4 / PS5"))
node_stream_actor(("Remote Play console"))

node_user -->|"uses"| node_app
node_app -.->|"reads and writes"| node_settings
node_app -->|"probes services"| node_console
node_console -->|"probes installer"| node_installer
node_console -->|"checks availability"| node_console_actor
node_app -->|"scans network"| node_lan
node_app -->|"discovers consoles"| node_discovery
node_app -->|"browses and transfers"| node_ftp
node_ftp -->|"FTP operations"| node_console_actor
node_app -->|"queues jobs"| node_queue
node_app -->|"opens games"| node_games
node_games -->|"converts discs"| node_disc
node_games -->|"inspects packages"| node_pkg
node_games -->|"installs packages"| node_installer
node_games -.->|"transfers game files"| node_ftp
node_app -->|"opens library"| node_shelf
node_shelf -->|"reads game sources"| node_library
node_shelf -->|"plans organization"| node_organizer
node_app -->|"opens store"| node_store
node_store -->|"fetches catalogs"| node_http
node_store -.->|"installs store apps"| node_installer
node_app -->|"opens save vault"| node_saves
node_saves -.->|"backs up and restores"| node_ftp
node_app -->|"manages payloads"| node_payloads
node_app -->|"manages cheats"| node_cheats
node_app -->|"opens Remote Play"| node_stream_ui
node_stream_ui -->|"controls session"| node_stream_session
node_stream_session -->|"streams media"| node_stream_actor

click node_app "https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/qt/app_controller.cpp"
click node_queue "https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/queue/install_queue.cpp"
click node_settings "https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/settings/settings_store.cpp"
click node_console "https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/console/console_manager.cpp"
click node_discovery "https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/stream/discovery.cpp"
click node_lan "https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/net/lan_scan.h"
click node_ftp "https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/ftp/ftp_client.cpp"
click node_installer "https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/installer/rpi_client.cpp"
click node_games "https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/qt/games_controller.cpp"
click node_disc "https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/fpkg/classic_converter.cpp"
click node_pkg "https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/pkg/pkg_inspector.h"
click node_organizer "https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/library/pkg_organizer.cpp"
click node_library "https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/library/console_library.h"
click node_shelf "https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/qt/shelf_controller.cpp"
click node_store "https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/qt/store_controller.cpp"
click node_saves "https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/saves/save_vault.cpp"
click node_payloads "https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/qt/payloads_controller.cpp"
click node_cheats "https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/cheats/cheats.cpp"
click node_stream_ui "https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/qt/stream_controller.cpp"
click node_stream_session "https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/stream/session.cpp"
click node_http "https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/net/http_client.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_queue,node_settings,node_user toneBlue
class node_console,node_discovery,node_lan,node_ftp,node_installer,node_http toneAmber
class node_games,node_disc,node_pkg,node_organizer toneMint
class node_library,node_shelf,node_store,node_saves,node_payloads,node_cheats toneRose
class node_stream_ui,node_stream_session,node_console_actor,node_stream_actor toneIndigo
```

## Components

### Desktop app

- [App controller](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/qt/app_controller.cpp): `src/orbislink/qt/app_controller.cpp`
- [Job queue](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/queue/install_queue.cpp): `src/orbislink/queue/install_queue.cpp`
- [Settings](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/settings/settings_store.cpp): `src/orbislink/settings/settings_store.cpp`

### Console connectivity

- [Console manager](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/console/console_manager.cpp): `src/orbislink/console/console_manager.cpp`
- [Console discovery](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/stream/discovery.cpp): `src/orbislink/stream/discovery.cpp`
- [LAN scanning](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/net/lan_scan.h): `src/orbislink/net/lan_scan.h`
- [FTP client](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/ftp/ftp_client.cpp): `src/orbislink/ftp/ftp_client.cpp`
- [Package installer API](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/installer/rpi_client.cpp): `src/orbislink/installer/rpi_client.cpp`
- [HTTP client](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/net/http_client.cpp): `src/orbislink/net/http_client.cpp`

### Games and packages

- [Games controller](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/qt/games_controller.cpp): `src/orbislink/qt/games_controller.cpp`
- [Classic disc converter](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/fpkg/classic_converter.cpp): `src/orbislink/fpkg/classic_converter.cpp`
- [Package inspector](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/pkg/pkg_inspector.h): `src/orbislink/pkg/pkg_inspector.h`
- [Package organizer](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/library/pkg_organizer.cpp): `src/orbislink/library/pkg_organizer.cpp`

### Library and services

- [Console game library](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/library/console_library.h): `src/orbislink/library/console_library.h`
- [Games shelf](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/qt/shelf_controller.cpp): `src/orbislink/qt/shelf_controller.cpp`
- [Homebrew store](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/qt/store_controller.cpp): `src/orbislink/qt/store_controller.cpp`
- [Save vault](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/saves/save_vault.cpp): `src/orbislink/saves/save_vault.cpp`
- [Payload manager](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/qt/payloads_controller.cpp): `src/orbislink/qt/payloads_controller.cpp`
- [Game cheats](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/cheats/cheats.cpp): `src/orbislink/cheats/cheats.cpp`

### Remote Play

- [Stream controller](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/qt/stream_controller.cpp): `src/orbislink/qt/stream_controller.cpp`
- [Streaming session](https://github.com/nosferatuzodd7/orbislink/blob/main/src/orbislink/stream/session.cpp): `src/orbislink/stream/session.cpp`

### Other components

- **Desktop user**
- **PS4 / PS5**
- **Remote Play console**

## Connections

- Desktop user → App controller: uses
- App controller → Settings: reads and writes
- App controller → Console manager: probes services
- Console manager → Package installer API: probes installer (evidence: `src/orbislink/console/console_manager.cpp`)
- Console manager → PS4 / PS5: checks availability
- App controller → LAN scanning: scans network (evidence: `src/orbislink/qt/app_controller.cpp`)
- App controller → Console discovery: discovers consoles
- App controller → FTP client: browses and transfers
- FTP client → PS4 / PS5: FTP operations
- App controller → Job queue: queues jobs
- App controller → Games controller: opens games
- Games controller → Classic disc converter: converts discs (evidence: `src/orbislink/qt/games_controller.cpp`)
- Games controller → Package inspector: inspects packages (evidence: `src/orbislink/qt/games_controller.cpp`)
- Games controller → Package installer API: installs packages
- Games controller → FTP client: transfers game files
- App controller → Games shelf: opens library
- Games shelf → Console game library: reads game sources (evidence: `src/orbislink/qt/shelf_controller.cpp`)
- Games shelf → Package organizer: plans organization (evidence: `src/orbislink/qt/shelf_controller.cpp`)
- App controller → Homebrew store: opens store
- Homebrew store → HTTP client: fetches catalogs (evidence: `src/orbislink/qt/store_controller.cpp`)
- Homebrew store → Package installer API: installs store apps
- App controller → Save vault: opens save vault
- Save vault → FTP client: backs up and restores
- App controller → Payload manager: manages payloads
- App controller → Game cheats: manages cheats
- App controller → Stream controller: opens Remote Play
- Stream controller → Streaming session: controls session (evidence: `src/orbislink/qt/stream_controller.cpp`)
- Streaming session → Remote Play console: streams media
