How sqshq/sampler works
Sampler is a terminal application for running configured shell commands at intervals and visualizing their output. The principal workflow is YAML configuration → configured samplers and display components → sampled command output → terminal rendering; users can also interactively rearrange components and save changed positions. Distinct display stages include run charts, sparklines, bar charts, gauges, textboxes, and ASCII art. Conditional triggers provide alert and action capabilities. The architecture follows the visible startup and event-handling code; several links to unsampled internals are documented by the README rather than verified from implementation excerpts.
Main entry points: main.go Application startup · layout.go Component layout · consumer.go Sample consumers · sampler.go Sampling scheduler
Components 17
Startup and configuration
- Application startup
main.go - YAML configuration
config/config.go
Sampling and actions
- Sampling scheduler
data/sampler.go - Sample consumers
data/consumer.go - Conditional triggers
data/trigger.go
Terminal visualization
Terminal runtime
- Event handler
event/handler.go - Terminal interface
console/console.go - Audio player
asset/player.go
Other components
- User
- Shell commands
Connections 36
- User → Application startup: starts
- Application startup → YAML configuration: loads
main.go - Application startup → Sampling scheduler: starts samplers
main.go - Application startup → Conditional triggers: creates triggers
main.go - Application startup → Run chart: creates
main.go - Application startup → Sparkline: creates
main.go - Application startup → Bar chart: creates
main.go - Application startup → Gauge: creates
main.go - Application startup → Textbox: creates
main.go - Application startup → ASCII box: creates
main.go - Application startup → Component layout: builds
main.go - Application startup → Event handler: starts handling
main.go - Application startup → Terminal interface: initializes
main.go - Application startup → Audio player: creates player
main.go - Sampling scheduler → Shell commands: executes commands
- Shell commands → Sampling scheduler: returns output
- Sampling scheduler → Sample consumers: delivers samples
- Sample consumers → Run chart: feeds samples
- Sample consumers → Sparkline: feeds samples
- Sample consumers → Bar chart: feeds samples
- Sample consumers → Gauge: feeds samples
- Sample consumers → Textbox: feeds samples
- Sample consumers → ASCII box: feeds samples
- Conditional triggers → Audio player: plays alerts
data/trigger.go - Conditional triggers → Shell commands: runs action script
data/trigger.go - Conditional triggers → Sample consumers: sends visual alerts
data/trigger.go - Event handler → Component layout: renders and routes input
event/handler.go - Event handler → Sampling scheduler: pauses samplers
event/handler.go - Component layout → Terminal interface: handles terminal input
- Event handler → YAML configuration: saves positions
event/handler.go - Component layout → Run chart: sends selection commands
component/layout/layout.go - Component layout → Sparkline: renders components
- Component layout → Bar chart: renders components
- Component layout → Gauge: renders components
- Component layout → Textbox: renders components
- Component layout → ASCII box: renders components