How gabe565/ascii-movie works
ASCII Movie is a Go CLI for listing and loading embedded or local ASCII movies, playing them interactively in a terminal, and serving streams over SSH and Telnet. The principal path is CLI dispatch → movie loading → player rendering, either locally or through a server session; server mode can also expose a metrics API queried by get stream. The README documents both server protocols and the interactive UI. Source excerpts establish the main calls; some server internals and movie-loading details are only indexed, so uncertain links are omitted.
Main entry points: cmd/cmd.go Command router · serve/cmd.go Serve command · player.go Interactive player · play/cmd.go Local play
Components 21
CLI commands
- Application entry
main.go - Command router
cmd/cmd.go - Local play
cmd/play/cmd.go - Serve command
cmd/serve/cmd.go - Movie listing
cmd/ls/cmd.go - Metrics command
cmd/get/stream/cmd.go - Runtime configuration
internal/config
Movie data
- Movie loading
internal/movie/load.go - Movie file handling
internal/movie/file.go - Movie metadata
internal/movie/info.go - Embedded movies
movies/movies_plain.go
Playback UI
- Interactive player
internal/player/player.go - Player styles
internal/player/styles.go
Streaming servers
- SSH streaming
internal/server/ssh.go - Telnet streaming
internal/server/telnet.go - Server configuration
internal/server/server.go
Stream monitoring
- Metrics API
internal/server/api.go - Stream information
internal/server/info.go
Other components
- Terminal user
- Remote client
- HTTP API client
Connections 28
- Terminal user → Application entry: runs
README.md - Application entry → Command router: creates
main.go - Command router → Runtime configuration: initializes
cmd/cmd.go - Command router → Local play: registers
cmd/cmd.go - Command router → Serve command: registers
cmd/cmd.go - Command router → Movie listing: registers
cmd/cmd.go - Command router → Metrics command: registers
cmd/cmd.go - Local play → Runtime configuration: loads settings
cmd/play/cmd.go - Local play → Movie loading: loads movie
cmd/play/cmd.go - Local play → Interactive player: starts playback
cmd/play/cmd.go - Serve command → Runtime configuration: loads settings
cmd/serve/cmd.go - Serve command → Movie loading: loads movie
cmd/serve/cmd.go - Serve command → Metrics API: creates API
cmd/serve/cmd.go - Serve command → SSH streaming: starts listener
cmd/serve/cmd.go - Serve command → Telnet streaming: starts listener
cmd/serve/cmd.go - Movie listing → Movie metadata: reads metadata
cmd/ls/cmd.go - Movie loading → Embedded movies: reads embedded data
internal/movie/load.go - Movie file handling → Embedded movies: reads movie files
internal/movie/file.go - Interactive player → Movie loading: uses frames
internal/player/player.go - Interactive player → Player styles: renders with
internal/player/player.go - Remote client → SSH streaming: connects by SSH
README.md - Remote client → Telnet streaming: connects by Telnet
README.md - SSH streaming → Interactive player: runs player
internal/server/ssh.go - Telnet streaming → Interactive player: runs player
internal/server/telnet.go - SSH streaming → Server configuration: uses server state
internal/server/ssh.go - Telnet streaming → Server configuration: uses server state
internal/server/telnet.go - Metrics API → Stream information: serves metrics
- HTTP API client → Metrics command: queries streams
cmd/get/stream/cmd.go