Expand description
Stargazer: D-STAR network observatory.
A headless Kubernetes-deployed service that discovers active D-STAR
reflectors, monitors real-time activity, captures voice transmissions with
metadata, decodes AMBE audio to MP3, and uploads completed streams to an
SDRTrunk-compatible Rdio API server for transcription.
ยงArchitecture
Stargazer operates in three tiers:
- Tier 1 (Discovery): polls Pi-Star, XLX API, and ircDDB to build a reflector registry.
- Tier 2 (Monitoring): connects to active XLX reflectors via UDP JSON monitor protocol for real-time activity events.
- Tier 3 (Capture): establishes full D-STAR protocol connections to capture and decode voice streams.
All tiers run as independent tokio tasks. A background upload processor sends completed streams to the Rdio API server. An HTTP API provides operational visibility and manual session control.
ยงUsage
stargazer --config stargazer.tomlModulesยง
- api ๐
- HTTP API server for operational visibility.
- config ๐
- Configuration for the stargazer service.
- db ๐
- Database connection pool, schema migrations, and typed query modules.
- tier1 ๐
- Tier 1: discovery and sweep.
- tier2 ๐
- Tier 2: XLX live monitoring via UDP JSON protocol.
- tier3 ๐
- Tier 3: deep D-STAR protocol connections and voice capture.
- upload ๐
- Rdio API upload queue processor.
Structsยง
- Cli ๐
- D-STAR network observatory โ reflector monitoring and voice capture service.