How yuroyami/syncplay-mobile works
Synkplay is a cross-platform Syncplay client for Android, iOS, desktop, and an early browser build. The primary workflow is to configure or join a room, load a local or linked video, become ready, and synchronize playback and room activity with other participants through the Syncplay protocol. Users can also watch alone or host a room locally. The graph combines README-documented capabilities with relationships visible in the supplied source index and excerpts; unsampled subsystems are included where the README establishes them, without assuming their internal call paths.
Main entry points: RoomViewmodel.kt Room Coordinator · NetworkManager.kt Client Transport · HomeScreen.kt Home and Invites · SyncplayServer.kt Syncplay Server
Components 23
App and Home
- App Entry
shared/src/app/Screen.kt - Home and Invites
shared/src/app/home/HomeScreen.kt - Preferences
shared/src/app/preferences/Preferences.kt
Room Experience
- Room Coordinator
shared/src/app/room/RoomViewmodel.kt - Room Interface
shared/src/app/room/RoomScreenUI.kt - Shared Playlist
shared/src/app/room/sharedplaylist/SharedPlaylistManager.kt - Chat and GIFs
shared/src/app/room/ui/chat/RoomSectionChat.kt - Subtitle Search
shared/src/app/subtitles/SubtitleSearch.kt
Media Playback
- Player Abstraction
shared/src/app/player/PlayerEngine.kt - Player Runtime
shared/src/app/player/PlayerManager.kt - Media Model
shared/src/app/player/models/MediaFile.kt - Platform Engines
shared/src@nonWeb/app/player/kite/KiteEngine.kt
Sync Protocol
- Protocol State
shared/src/app/protocol/ProtocolManager.kt - Wire Messages
shared/src/app/protocol/WireMessage.kt - Client Transport
shared/src/app/protocol/network/NetworkManager.kt - Platform Transports
shared/src@jvmShared/app/protocol/network/NettyNetworkManager.kt
Room Hosting
- Syncplay Server
shared/src/app/server/SyncplayServer.kt - Server Connections
shared/src/app/server/ClientConnection.kt - Server Transport
shared/src/app/server/network/ServerNetworkEngine.kt
Other components
- Viewer
- Syncplay Server
- OpenSubtitles
- Local or Linked Media
Connections 25
- Viewer → App Entry: opens app
- App Entry → Home and Invites: shows home
- Viewer → Home and Invites: configures room
- Home and Invites → Room Coordinator: joins room
- Room Coordinator → Client Transport: connects through
shared/src/app/room/RoomViewmodel.kt - Client Transport → Platform Transports: uses transport
shared/src@jvmShared/app/protocol/network/NettyNetworkManager.kt - Client Transport → Syncplay Server: exchanges protocol
- Room Coordinator → Protocol State: creates protocol state
shared/src/app/room/RoomViewmodel.kt - Protocol State → Wire Messages: sends messages
shared/src/app/protocol/ProtocolManager.kt - Viewer → Room Interface: controls room
- Room Coordinator → Room Interface: supplies room state
- Room Coordinator → Player Runtime: owns player
shared/src/app/room/RoomViewmodel.kt - Player Runtime → Player Abstraction: selects engine
- Player Abstraction → Platform Engines: creates implementation
shared/src@nonWeb/app/player/kite/KiteEngine.kt - Viewer → Local or Linked Media: chooses media
- Local or Linked Media → Media Model: loads media
- Viewer → Shared Playlist: manages playlist
- Viewer → Chat and GIFs: chats and shares GIFs
- Viewer → Subtitle Search: searches subtitles
- Subtitle Search → OpenSubtitles: searches catalog
- Viewer → Preferences: sets preferences
- Viewer → Syncplay Server: hosts room
- Server Transport → Syncplay Server: accepts connections
shared/src/app/server/network/ServerNetworkEngine.kt - Server Transport → Server Connections: passes packets
shared/src/app/server/network/ServerNetworkEngine.kt - Server Connections → Syncplay Server: dispatches client actions
shared/src/app/server/ClientConnection.kt