How alexballas/go2tv works
Go2TV casts local or remote media to DLNA/UPnP and Chromecast receivers. The main workflow is to choose media and a discovered device, prepare a stream (including optional transcoding or subtitles), then control playback. The GUI, CLI, and server-mode Web UI are distinct entry points; playback adapters bridge shared orchestration to device protocols. The README documents additional playlist, seek, RTMP, and desktop-casting capabilities. Connections reflect excerpts and documented behavior; unsampled implementation details are not inferred.
Main entry points: handler.go Web UI API · adapters.go Playback adapters · main.go Desktop GUI · go2tv.go CLI
Components 22
User interfaces
- Desktop GUI
internal/gui/main.go - CLI
cmd/go2tv/go2tv.go - Lite CLI
cmd/go2tv-lite/go2tv.go - Web UI client
internal/webui/src/client.js
Media preparation
- Media library
internal/library/library.go - Media HTTP server
internal/mediaserver/server.go - CLI media server
httphandlers/httphandlers.go - Artwork resolution
internal/mediaartwork/mediaartwork.go - Transcoding tools
utils/transcode.go - RTMP streaming
rtmp/server.go
Playback control
- Playback controller
internal/controller/controller.go - Playlists
castprotocol/v2/playlists/playlists.go
Device protocols
- Device discovery
devices/devices.go - Playback adapters
internal/playbackadapter/adapters.go - Cast client
castprotocol/client.go - Cast application
castprotocol/v2/application/application.go - DLNA control
soapcalls/soapcallers.go
Remote services
- Web UI API
internal/webui/handler.go - Remote session
internal/gui/remote_web_session.go
Other components
- User
- Browser
- TV or Chromecast
Connections 32
- User → Desktop GUI: selects and plays
- User → CLI: invokes playback
- User → Lite CLI: invokes playback
- User → Device discovery: requests discovery
- Desktop GUI → Device discovery: shows devices
internal/gui/main.go - CLI → Device discovery: lists devices
cmd/go2tv/go2tv.go - Lite CLI → Device discovery: lists devices
cmd/go2tv-lite/go2tv.go - CLI → CLI media server: serves media
cmd/go2tv/go2tv.go - Lite CLI → CLI media server: serves media
cmd/go2tv-lite/go2tv.go - Desktop GUI → Playback controller: controls playback
- CLI → Playback adapters: controls device
- Lite CLI → Playback adapters: controls device
- Browser → Web UI client: controls casting
- Web UI client → Web UI API: sends commands
- Web UI API → Media library: browses media
internal/webui/handler.go - Web UI API → Playback controller: executes commands
internal/webui/handler.go - Web UI API → Artwork resolution: resolves artwork
internal/webui/handler.go - Desktop GUI → Remote session: starts session
internal/gui/remote_web_session.go - Remote session → Web UI API: configures server
- Playback controller → Media HTTP server: routes media
internal/controller/controller.go - Playback controller → Playback adapters: dispatches playback
- Playback adapters → Cast client: creates client
internal/playbackadapter/adapters.go - Cast client → Cast application: starts receiver
castprotocol/client.go - Playback adapters → DLNA control: opens DLNA transport
internal/playbackadapter/adapters.go - Media HTTP server → TV or Chromecast: streams media
- DLNA control → TV or Chromecast: controls playback
- Cast client → TV or Chromecast: controls casting
- User → Playlists: manages playlist
- User → Transcoding tools: enables transcoding
- User → RTMP streaming: starts live stream
- User → Artwork resolution: views artwork
- User → Media HTTP server: casts desktop