How playbridgeapp/playbridge works
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: CastSessionManager.kt Cast session · BrowserActivity.kt Android sender · ServerService.kt Android TV service · main.rs Rust CLI
Components 23
Sender apps
- Android sender
mobile/android/app/src/main/java/com/playbridge/sender/browser/BrowserActivity.kt - Rust CLI
cli/src/main.rs
Casting runtime
- Device discovery
cast/core/src/discovery.rs - Cast session
mobile/android/app/src/main/java/com/playbridge/sender/cast/CastSessionManager.kt - Stream routing
mobile/android/app/src/main/java/com/playbridge/sender/cast/proxy/StreamRouteService.kt - Stream proxy
stream-proxy-rust/src/server.rs - DLNA casting
cast/core/src/upnp.rs - Apple TV remote
cast/core/src/atv_remote/control.rs - Screen mirroring
mobile/android/app/src/main/java/com/playbridge/sender/cast/mirror/ScreenMirrorCoordinator.kt
Receivers
- Android TV service
tv/android/player/app/src/main/java/com/playbridge/player/server/ServerService.kt - Receiver messaging
tv/android/player/app/src/main/java/com/playbridge/player/server/WebSocketServer.kt - Media renderer
tv/android/player/app/src/main/java/com/playbridge/player/player/ExoRendererService.kt - Exo playback engine
shared/src/androidMain/kotlin/com/playbridge/shared/player/ExoPlayerEngine.kt - Desktop receiver
browser-receiver-rust/src/main.rs - Apple TV receiver
tv/apple/PlayBridge TV/PlayBridge TV/Player/PlaybackEngine.swift - Desktop receiver
desktop/linux/runner/my_application.cc
Shared sessions
- Together room engine
cast/together/src/engine.rs - Together client
cast/together/src/client.rs - Room relay
Browser tools
- Browser extension
extension/src/background.ts - Ad blocking
cast/core/src/adblock_engine.rs - TV browser
tv/android/geckoview-plugin/app/src/main/java/com/playbridge/geckoview/plugin/GeckoViewEngine.kt
Other components
- Sender user
Connections 23
- Sender user → Android sender: selects media
README.md - Sender user → Rust CLI: starts casting
README.md - Sender user → Browser extension: detects media
README.md - Android sender → Device discovery: discovers targets
- Rust CLI → Device discovery: discovers targets
cli/src/main.rs - Android sender → Cast session: starts session
- Cast session → Stream routing: packages media
- Stream routing → Stream proxy: publishes stream
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
mobile/android/app/src/main/java/com/playbridge/sender/cast/CastSessionService.kt - Android TV service → Receiver messaging: serves commands
tv/android/player/app/src/main/java/com/playbridge/player/server/ServerService.kt - Android TV service → Media renderer: dispatches playback
tv/android/player/app/src/main/java/com/playbridge/player/server/ServerService.kt - Media renderer → Exo playback engine: uses engine
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