How vega-org/vega-app works
Vega is an Android media-streaming and casting app. The main user journey is to browse or search provider-sourced media, open a title, and stream it locally or cast it; users can also download media and manage a watchlist. The app additionally supports custom provider plugins, external players/downloaders, and desktop sync. The graph combines documented capabilities with relationships visible in the supplied excerpts and SOURCE INDEX; unsampled implementation details are represented at subsystem level, without asserting unverified call paths.
Main entry points: Player.tsx Local player · App.tsx App navigation · SearchResults.tsx Search results · ProviderManager.ts Provider manager
Components 23
App and discovery
- App navigation
src/App.tsx - Search
src/screens/Search.tsx - Search results
src/screens/SearchResults.tsx - Title details
src/screens/home/Info.tsx
Providers and persistence
- Provider sources
src/screens/settings/components/ProviderSourceManager.tsx - Provider manager
src/lib/services/ProviderManager.ts - Plugin manager
src/lib/services/ExtensionManager.ts - Provider storage
src/lib/storage/extensionStorage.ts - App storage
src/lib/storage/StorageService.ts
Playback and casting
- Local player
src/screens/home/Player.tsx - Stream selection
src/lib/hooks/useStream.ts - Video controls
src/components/media-console/VideoPlayer.tsx - Remote playback
src/lib/remote/remotePlaybackManager.ts - Remote delivery
src/lib/remote/remoteDeliveryService.ts - Android delivery
native-src/android/com/vega/RemoteDeliveryModule.kt - Cast or DLNA device
Downloads and sync
- Watchlist
src/lib/storage/WatchListStorage.ts - Download manager
src/lib/downloadManager.ts - Download backends
src/lib/downloadBackends/registry.ts - Download records
src/lib/storage/DownloadsStorage.ts - Desktop sync
src/lib/sync/syncService.ts
Other components
- Viewer
- Desktop app
Connections 23
- Viewer → App navigation: opens
README.md - App navigation → Search: routes to
src/App.tsx - Search → Search results: submits query
README.md - Search results → Provider manager: requests providers
src/screens/SearchResults.tsx - Provider manager → Plugin manager: uses plugins
src/lib/services/ProviderManager.ts - Provider manager → Provider storage: reads provider data
src/lib/services/ProviderManager.ts - Provider sources → Provider storage: updates sources
src/screens/settings/components/ProviderSourceManager.tsx - Provider storage → App storage: persists data
src/lib/storage/extensionStorage.ts - Search results → Title details: opens title
README.md - Title details → Local player: starts playback
README.md - Local player → Stream selection: selects stream
src/screens/home/Player.tsx - Local player → Video controls: renders controls
src/screens/home/Player.tsx - Local player → Remote playback: starts casting
src/screens/home/Player.tsx - Remote playback → Remote delivery: prepares delivery
src/lib/remote/remotePlaybackManager.ts - Remote delivery → Android delivery: uses native module
- Remote playback → Cast or DLNA device: casts media
README.md - Viewer → Watchlist: manages titles
README.md - Viewer → Download manager: requests download
README.md - Download manager → Download backends: selects backend
src/lib/downloadManager.ts - Download manager → Download records: updates records
src/lib/downloadManager.ts - Download records → App storage: persists data
src/lib/storage/index.ts - App navigation → Desktop sync: starts sync
src/App.tsx - Desktop sync → Desktop app: syncs with
README.md