How frequencehit/heron-broadcaster works
Heron is a self-hosted radio automation system: operators use the web interface to manage a music library and programming, then the API coordinates playback through station engines to streaming outputs. Separate product branches cover library ingestion and analysis, rotation, audio processing, listener-facing features, backups, and monitoring. The graph combines README-documented capabilities with sampled routing and engine/output excerpts; several subsystem links are documented rather than verified in unsampled implementation files.
Main entry points: app.rs HTTP API · engine.rs Station engine · App.tsx Web interface · index.ts Typed API client
Components 23
Web and API
- Web interface
web/src/App.tsx - Typed API client
web/src/api/index.ts - HTTP API
crates/api/src/app.rs - Sessions and roles
crates/api/src/auth.rs
Library and Programming
- Library management
crates/api/src/library.rs - Import and review
crates/api/src/import.rs - File organization
crates/librarian/src/journal.rs - Track analysis
crates/analysis/src/analyzer.rs - Music rotation
crates/rotation/src/select.rs - Medley creation
crates/core/src/medley.rs
Playback and Audio
- Station engine
crates/engine/src/engine.rs - Engine link
crates/api/src/engine.rs - Encoding and outputs
crates/outputs/src/pipeline.rs - Audio processing
crates/dsp/src/agc/mod.rs
Listeners and Integrations
- Listener features
crates/core/src/shows.rs - Public gateway
crates/api/src/gateway.rs - Listener statistics
crates/api/src/listeners/mod.rs - Webhooks
crates/api/src/webhooks.rs
Operations
- Application database
crates/service/src/db.rs - Backups
crates/api/src/backups/mod.rs - Monitoring
crates/service/src/telemetry.rs
Other components
- Radio operator
- Icecast servers
Connections 22
- Radio operator → Web interface: operates
- Web interface → Typed API client: uses
web/src/App.tsx - Typed API client → HTTP API: requests
web/src/api/index.ts - HTTP API → Sessions and roles: routes through
crates/api/src/app.rs - HTTP API → Library management: routes to
crates/api/src/app.rs - HTTP API → Import and review: routes to
crates/api/src/app.rs - Import and review → File organization: files and imports
- Library management → Track analysis: analyzes tracks
- HTTP API → Music rotation: manages programming
- HTTP API → Application database: persists state
- HTTP API → Engine link: controls
- Engine link → Station engine: calls over gRPC
crates/api/src/engine.rs - Station engine → Encoding and outputs: streams audio
crates/outputs/src/pipeline.rs - Station engine → Audio processing: processes audio
- Encoding and outputs → Icecast servers: streams to
- HTTP API → Medley creation: manages
- HTTP API → Listener features: manages
- Listener features → Public gateway: exposes interactions
- Icecast servers → Listener statistics: provides listener counts
- HTTP API → Webhooks: configures
crates/api/src/app.rs - HTTP API → Backups: provides backup operations
crates/api/src/app.rs - HTTP API → Monitoring: pushes telemetry