How synctv-org/synctv works
SyncTV is a real-time synchronized video-watching platform. A client or administrator uses its HTTP, gRPC, or WebSocket surfaces to authenticate, manage rooms and media, and coordinate playback; realtime services distribute room events, while provider integrations supply playable media. The product also supports live publishing and playback, file storage, and clustered operation. The graph combines documented capabilities with relationships visible in sampled source references; several feature implementations were not sampled, so their connections are shown only where documented or left unlinked.
Main entry points: admin.rs API implementations · app.rs Application startup · http/mod.rs HTTP API · grpc/mod.rs gRPC API
Components 21
API surfaces
- HTTP API
synctv-api-http/src/http/mod.rs - gRPC API
synctv-api-grpc/src/grpc/mod.rs - API implementations
synctv-api-common/src/impls/admin.rs
Room and media
- Room operations
synctv-api-common/src/impls/client/room.rs - Playback operations
synctv-api-common/src/impls/playback.rs - Media operations
synctv-api-common/src/impls/client/media.rs - Media models
synctv-core/src/models/media.rs
Realtime and live
- Messaging
synctv-api-common/src/impls/messaging.rs - Realtime manager
synctv-realtime/src/sync/realtime_manager.rs - Connection manager
synctv-realtime/src/sync/connection_manager.rs - Livestream services
synctv-livestream/src/livestream/external_publish_manager.rs - RTMP session
synctv-xiu/src/rtmp/session/client_session.rs
Runtime and storage
- Application startup
synctv/src/app.rs - Server lifecycle
synctv/src/server.rs - Cluster discovery
synctv-cluster/src/discovery/node_registry.rs - Tiered cache
synctv-core/src/cache/tiered.rs - File storage
synctv-core/src/service/file_storage.rs - File repository
synctv-core/src/repository/file_storage.rs
Providers
- Provider adapters
synctv-core/src/provider/mod.rs
Other components
- Client
- Administrator
Connections 20
- Client → HTTP API: uses
README.md - Client → gRPC API: uses
README.md - Administrator → HTTP API: uses
README.md - Administrator → gRPC API: uses
README.md - HTTP API → API implementations: dispatches
- gRPC API → API implementations: dispatches
- API implementations → Room operations: delegates
- API implementations → Playback operations: delegates
synctv-api-common/src/impls/admin.rs - API implementations → Media operations: delegates
synctv-api-common/src/impls/admin.rs - Media operations → Provider adapters: uses
- Room operations → Messaging: publishes events
- Messaging → Realtime manager: dispatches
- Realtime manager → Connection manager: manages connections
synctv-realtime/src/sync/realtime_manager.rs - Playback operations → Media models: uses
- Application startup → Server lifecycle: starts
synctv/src/app.rs - Application startup → Cluster discovery: initializes
synctv/src/app.rs - Application startup → Tiered cache: initializes
- File storage → File repository: persists metadata
- Client → Livestream services: publishes or watches
README.md - RTMP session → Livestream services: feeds streams