# playbridgeapp/playbridge architecture

> Architecture diagram of the GitHub repository playbridgeapp/playbridge, 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/playbridgeapp/playbridge
- Repository: https://github.com/playbridgeapp/playbridge

## Overview

PlayBridge is a multi-platform, local-network casting suite: a sender discovers or selects a receiver, prepares media for that target, then controls playback; receivers accept sessions and render media. The map preserves major README capabilities—including DLNA, browser-based sending, screen mirroring, ad blocking, and synchronized Together sessions—while emphasizing the sampled Android/Rust runtime. Several branches are documented by the README or source index but not fully sampled, so their links are dashed where the implementation relationship is unverified.

Main entry points: [`mobile/android/app/src/main/java/com/playbridge/sender/cast/CastSessionManager.kt`](https://github.com/playbridgeapp/playbridge/blob/main/mobile/android/app/src/main/java/com/playbridge/sender/cast/CastSessionManager.kt) (Cast session), [`mobile/android/app/src/main/java/com/playbridge/sender/browser/BrowserActivity.kt`](https://github.com/playbridgeapp/playbridge/blob/main/mobile/android/app/src/main/java/com/playbridge/sender/browser/BrowserActivity.kt) (Android sender), [`tv/android/player/app/src/main/java/com/playbridge/player/server/ServerService.kt`](https://github.com/playbridgeapp/playbridge/blob/main/tv/android/player/app/src/main/java/com/playbridge/player/server/ServerService.kt) (Android TV service), [`cli/src/main.rs`](https://github.com/playbridgeapp/playbridge/blob/main/cli/src/main.rs) (Rust CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_send["Sender apps"]
  node_phone["Android sender<br/>[BrowserActivity.kt]"]
  node_cli["Rust CLI<br/>[main.rs]"]
end

subgraph group_cast["Casting runtime"]
  node_discovery["Device discovery<br/>[discovery.rs]"]
  node_session["Cast session"]
  node_routing["Stream routing"]
  node_proxy["Stream proxy<br/>[server.rs]"]
  node_dlna["DLNA casting<br/>[upnp.rs]"]
  node_atv["Apple TV remote<br/>[control.rs]"]
  node_mirror["Screen mirroring"]
end

subgraph group_receive["Receivers"]
  node_receiver["Android TV service<br/>[ServerService.kt]"]
  node_websocket["Receiver messaging<br/>[WebSocketServer.kt]"]
  node_renderer["Media renderer"]
  node_player["Exo playback engine<br/>[ExoPlayerEngine.kt]"]
  node_browserreceiver["Desktop receiver<br/>[main.rs]"]
  node_apple["Apple TV receiver"]
  node_desktop["Desktop receiver<br/>[my_application.cc]"]
end

subgraph group_together["Shared sessions"]
  node_togetherengine["Together room engine<br/>[engine.rs]"]
  node_togetherclient["Together client<br/>[client.rs]"]
  node_relay(("Room relay"))
end

subgraph group_browser["Browser tools"]
  node_extension["Browser extension<br/>[background.ts]"]
  node_adblock["Ad blocking<br/>[adblock_engine.rs]"]
  node_geckoview["TV browser<br/>[GeckoViewEngine.kt]"]
end

node_user(("Sender user"))

node_user -->|"selects media"| node_phone
node_user -->|"starts casting"| node_cli
node_user -->|"detects media"| node_extension
node_phone -.->|"discovers targets"| node_discovery
node_cli -->|"discovers targets"| node_discovery
node_phone -.->|"starts session"| node_session
node_session -.->|"packages media"| node_routing
node_routing -->|"publishes stream"| node_proxy
node_session -.->|"sends playback"| node_receiver
node_cli -.->|"casts media"| node_receiver
node_discovery -.->|"finds renderers"| node_dlna
node_session -.->|"controls device"| node_atv
node_session -->|"starts mirror"| node_mirror
node_receiver -->|"serves commands"| node_websocket
node_receiver -->|"dispatches playback"| node_renderer
node_renderer -->|"uses engine"| node_player
node_browserreceiver -.->|"plays media"| node_player
node_geckoview -.->|"blocks content"| node_adblock
node_togetherclient -.->|"feeds room events"| node_togetherengine
node_togetherclient -.->|"exchanges frames"| node_relay
node_togetherengine -.->|"returns outputs"| node_togetherclient
node_apple -.->|"receives cast"| node_phone
node_desktop -.->|"receives cast"| node_phone

click node_phone "https://github.com/playbridgeapp/playbridge/blob/main/mobile/android/app/src/main/java/com/playbridge/sender/browser/BrowserActivity.kt"
click node_cli "https://github.com/playbridgeapp/playbridge/blob/main/cli/src/main.rs"
click node_extension "https://github.com/playbridgeapp/playbridge/blob/main/extension/src/background.ts"
click node_discovery "https://github.com/playbridgeapp/playbridge/blob/main/cast/core/src/discovery.rs"
click node_session "https://github.com/playbridgeapp/playbridge/blob/main/mobile/android/app/src/main/java/com/playbridge/sender/cast/CastSessionManager.kt"
click node_routing "https://github.com/playbridgeapp/playbridge/blob/main/mobile/android/app/src/main/java/com/playbridge/sender/cast/proxy/StreamRouteService.kt"
click node_proxy "https://github.com/playbridgeapp/playbridge/blob/main/stream-proxy-rust/src/server.rs"
click node_dlna "https://github.com/playbridgeapp/playbridge/blob/main/cast/core/src/upnp.rs"
click node_atv "https://github.com/playbridgeapp/playbridge/blob/main/cast/core/src/atv_remote/control.rs"
click node_mirror "https://github.com/playbridgeapp/playbridge/blob/main/mobile/android/app/src/main/java/com/playbridge/sender/cast/mirror/ScreenMirrorCoordinator.kt"
click node_receiver "https://github.com/playbridgeapp/playbridge/blob/main/tv/android/player/app/src/main/java/com/playbridge/player/server/ServerService.kt"
click node_websocket "https://github.com/playbridgeapp/playbridge/blob/main/tv/android/player/app/src/main/java/com/playbridge/player/server/WebSocketServer.kt"
click node_renderer "https://github.com/playbridgeapp/playbridge/blob/main/tv/android/player/app/src/main/java/com/playbridge/player/player/ExoRendererService.kt"
click node_player "https://github.com/playbridgeapp/playbridge/blob/main/shared/src/androidMain/kotlin/com/playbridge/shared/player/ExoPlayerEngine.kt"
click node_browserreceiver "https://github.com/playbridgeapp/playbridge/blob/main/browser-receiver-rust/src/main.rs"
click node_adblock "https://github.com/playbridgeapp/playbridge/blob/main/cast/core/src/adblock_engine.rs"
click node_geckoview "https://github.com/playbridgeapp/playbridge/blob/main/tv/android/geckoview-plugin/app/src/main/java/com/playbridge/geckoview/plugin/GeckoViewEngine.kt"
click node_togetherengine "https://github.com/playbridgeapp/playbridge/blob/main/cast/together/src/engine.rs"
click node_togetherclient "https://github.com/playbridgeapp/playbridge/blob/main/cast/together/src/client.rs"
click node_apple "https://github.com/playbridgeapp/playbridge/blob/main/tv/apple/PlayBridge%20TV/PlayBridge%20TV/Player/PlaybackEngine.swift"
click node_desktop "https://github.com/playbridgeapp/playbridge/blob/main/desktop/linux/runner/my_application.cc"

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_phone,node_cli,node_user toneBlue
class node_discovery,node_session,node_routing,node_proxy,node_dlna,node_atv,node_mirror toneAmber
class node_receiver,node_websocket,node_renderer,node_player,node_browserreceiver,node_apple,node_desktop toneMint
class node_togetherengine,node_togetherclient,node_relay toneRose
class node_extension,node_adblock,node_geckoview toneIndigo
```

## Components

### Sender apps

- [Android sender](https://github.com/playbridgeapp/playbridge/blob/main/mobile/android/app/src/main/java/com/playbridge/sender/browser/BrowserActivity.kt): `mobile/android/app/src/main/java/com/playbridge/sender/browser/BrowserActivity.kt`
- [Rust CLI](https://github.com/playbridgeapp/playbridge/blob/main/cli/src/main.rs): `cli/src/main.rs`

### Casting runtime

- [Device discovery](https://github.com/playbridgeapp/playbridge/blob/main/cast/core/src/discovery.rs): `cast/core/src/discovery.rs`
- [Cast session](https://github.com/playbridgeapp/playbridge/blob/main/mobile/android/app/src/main/java/com/playbridge/sender/cast/CastSessionManager.kt): `mobile/android/app/src/main/java/com/playbridge/sender/cast/CastSessionManager.kt`
- [Stream routing](https://github.com/playbridgeapp/playbridge/blob/main/mobile/android/app/src/main/java/com/playbridge/sender/cast/proxy/StreamRouteService.kt): `mobile/android/app/src/main/java/com/playbridge/sender/cast/proxy/StreamRouteService.kt`
- [Stream proxy](https://github.com/playbridgeapp/playbridge/blob/main/stream-proxy-rust/src/server.rs): `stream-proxy-rust/src/server.rs`
- [DLNA casting](https://github.com/playbridgeapp/playbridge/blob/main/cast/core/src/upnp.rs): `cast/core/src/upnp.rs`
- [Apple TV remote](https://github.com/playbridgeapp/playbridge/blob/main/cast/core/src/atv_remote/control.rs): `cast/core/src/atv_remote/control.rs`
- [Screen mirroring](https://github.com/playbridgeapp/playbridge/blob/main/mobile/android/app/src/main/java/com/playbridge/sender/cast/mirror/ScreenMirrorCoordinator.kt): `mobile/android/app/src/main/java/com/playbridge/sender/cast/mirror/ScreenMirrorCoordinator.kt`

### Receivers

- [Android TV service](https://github.com/playbridgeapp/playbridge/blob/main/tv/android/player/app/src/main/java/com/playbridge/player/server/ServerService.kt): `tv/android/player/app/src/main/java/com/playbridge/player/server/ServerService.kt`
- [Receiver messaging](https://github.com/playbridgeapp/playbridge/blob/main/tv/android/player/app/src/main/java/com/playbridge/player/server/WebSocketServer.kt): `tv/android/player/app/src/main/java/com/playbridge/player/server/WebSocketServer.kt`
- [Media renderer](https://github.com/playbridgeapp/playbridge/blob/main/tv/android/player/app/src/main/java/com/playbridge/player/player/ExoRendererService.kt): `tv/android/player/app/src/main/java/com/playbridge/player/player/ExoRendererService.kt`
- [Exo playback engine](https://github.com/playbridgeapp/playbridge/blob/main/shared/src/androidMain/kotlin/com/playbridge/shared/player/ExoPlayerEngine.kt): `shared/src/androidMain/kotlin/com/playbridge/shared/player/ExoPlayerEngine.kt`
- [Desktop receiver](https://github.com/playbridgeapp/playbridge/blob/main/browser-receiver-rust/src/main.rs): `browser-receiver-rust/src/main.rs`
- [Apple TV receiver](https://github.com/playbridgeapp/playbridge/blob/main/tv/apple/PlayBridge%20TV/PlayBridge%20TV/Player/PlaybackEngine.swift): `tv/apple/PlayBridge TV/PlayBridge TV/Player/PlaybackEngine.swift`
- [Desktop receiver](https://github.com/playbridgeapp/playbridge/blob/main/desktop/linux/runner/my_application.cc): `desktop/linux/runner/my_application.cc`

### Shared sessions

- [Together room engine](https://github.com/playbridgeapp/playbridge/blob/main/cast/together/src/engine.rs): `cast/together/src/engine.rs`
- [Together client](https://github.com/playbridgeapp/playbridge/blob/main/cast/together/src/client.rs): `cast/together/src/client.rs`
- **Room relay**

### Browser tools

- [Browser extension](https://github.com/playbridgeapp/playbridge/blob/main/extension/src/background.ts): `extension/src/background.ts`
- [Ad blocking](https://github.com/playbridgeapp/playbridge/blob/main/cast/core/src/adblock_engine.rs): `cast/core/src/adblock_engine.rs`
- [TV browser](https://github.com/playbridgeapp/playbridge/blob/main/tv/android/geckoview-plugin/app/src/main/java/com/playbridge/geckoview/plugin/GeckoViewEngine.kt): `tv/android/geckoview-plugin/app/src/main/java/com/playbridge/geckoview/plugin/GeckoViewEngine.kt`

### Other components

- **Sender user**

## Connections

- Sender user → Android sender: selects media (evidence: `README.md`)
- Sender user → Rust CLI: starts casting (evidence: `README.md`)
- Sender user → Browser extension: detects media (evidence: `README.md`)
- Android sender → Device discovery: discovers targets
- Rust CLI → Device discovery: discovers targets (evidence: `cli/src/main.rs`)
- Android sender → Cast session: starts session
- Cast session → Stream routing: packages media
- Stream routing → Stream proxy: publishes stream (evidence: `mobile/android/app/src/main/java/com/playbridge/sender/cast/proxy/StreamRouteService.kt`)
- Cast session → Android TV service: sends playback
- Rust CLI → Android TV service: casts media
- Device discovery → DLNA casting: finds renderers
- Cast session → Apple TV remote: controls device
- Cast session → Screen mirroring: starts mirror (evidence: `mobile/android/app/src/main/java/com/playbridge/sender/cast/CastSessionService.kt`)
- Android TV service → Receiver messaging: serves commands (evidence: `tv/android/player/app/src/main/java/com/playbridge/player/server/ServerService.kt`)
- Android TV service → Media renderer: dispatches playback (evidence: `tv/android/player/app/src/main/java/com/playbridge/player/server/ServerService.kt`)
- Media renderer → Exo playback engine: uses engine (evidence: `tv/android/player/app/src/main/java/com/playbridge/player/player/ExoRendererService.kt`)
- Desktop receiver → Exo playback engine: plays media
- TV browser → Ad blocking: blocks content
- Together client → Together room engine: feeds room events
- Together client → Room relay: exchanges frames
- Together room engine → Together client: returns outputs
- Apple TV receiver → Android sender: receives cast
- Desktop receiver → Android sender: receives cast
