How w9ml/squelch works
Squelch is a self-hosted, receive-only AllStarLink monitor: node audio is segmented into transmissions, enriched with radio metadata and speech/voice analysis, persisted, then exposed through a live searchable web UI. The graph keeps the documented optional capabilities visible; links are limited to relationships supported by the README or supplied source excerpts/index references, so unsampled implementation details are not treated as inspected.
Main entry points: pipeline.py Transmission pipeline · web.py FastAPI service · db.py Transmission database · Feed.tsx Live transmission feed
Components 32
Radio ingest
- USRP segmenter
squelch/usrp.py - Node MDC forwarding
squelch/mdc_ingest.py - Node source events
squelch/source_ingest.py
Transmission analysis
- Transmission pipeline
squelch/pipeline.py - Speech transcription
squelch/transcribe.py - Live captions
squelch/livecaption.py - MDC audio decode
squelch/mdc1200.py - DTMF decode
squelch/dtmf.py - Voice identification
squelch/speakerid.py - TitaNet backend
squelch/titanet.py - Callsign extraction
squelch/callsigns.py - Callsign correction
squelch/qrz.py - Watchlist matching
squelch/watchlist.py - Voter RSSI
squelch/voter.py
Persistence and events
- Transmission database
squelch/db.py - Live event broadcaster
squelch/events.py
Web services
- Runtime configuration
squelch/config.py - FastAPI service
squelch/web.py - Accounts and sessions
squelch/auth.py - Web push alerts
squelch/webpush.py - Case and data exports
squelch/export.py
Browser experience
- Live transmission feed
web/src/components/Feed.tsx - Transmission cards
web/src/components/TransmissionCard.tsx - Waveform playback
web/src/components/WaveformPlayer.tsx - Browser API client
web/src/lib/api.ts - Browser application state
web/src/state/app-context.tsx - Case management UI
web/src/components/modals/CasesModal.tsx - Admin settings UI
web/src/components/modals/SettingsModal.tsx
Other components
- AllStarLink node
- Monitor user
- QRZ service
- Browser or webhook targets
Connections 37
- AllStarLink node → USRP segmenter: streams audio
- USRP segmenter → Transmission pipeline: submits segments
squelch/pipeline.py - Transmission pipeline → Transmission database: stores transmissions
squelch/pipeline.py - Transmission pipeline → MDC audio decode: decodes MDC
squelch/pipeline.py - Transmission pipeline → DTMF decode: decodes tones
squelch/pipeline.py - Transmission pipeline → Speech transcription: transcribes audio
squelch/pipeline.py - Transmission pipeline → Voice identification: identifies voice
squelch/pipeline.py - Voice identification → TitaNet backend: uses backend
squelch/speakerid.py - Transmission pipeline → Callsign extraction: extracts callsigns
squelch/pipeline.py - Transmission pipeline → Callsign correction: checks callsigns
squelch/pipeline.py - Callsign correction → QRZ service: enriches stations
- Transmission pipeline → Watchlist matching: matches alerts
squelch/pipeline.py - Transmission pipeline → Web push alerts: sends alerts
squelch/pipeline.py - Web push alerts → Browser or webhook targets: delivers notices
- AllStarLink node → Node MDC forwarding: forwards MDC
squelch/mdc_ingest.py - Node MDC forwarding → Transmission database: attaches identifiers
squelch/mdc_ingest.py - AllStarLink node → Node source events: reports audio origin
squelch/source_ingest.py - Node source events → Transmission database: updates origin
squelch/source_ingest.py - Transmission pipeline → Live event broadcaster: publishes updates
squelch/pipeline.py - Live event broadcaster → FastAPI service: broadcasts feed
squelch/web.py - FastAPI service → Transmission database: reads and writes
squelch/web.py - FastAPI service → Accounts and sessions: checks access
squelch/web.py - Accounts and sessions → Transmission database: stores accounts
squelch/auth.py - FastAPI service → Case and data exports: serves case exports
squelch/web.py - FastAPI service → Runtime configuration: uses settings
squelch/web.py - Monitor user → Live transmission feed: views transmissions
- Live transmission feed → Browser application state: reads state
web/src/components/Feed.tsx - Live transmission feed → Transmission cards: renders cards
web/src/components/Feed.tsx - Transmission cards → Waveform playback: renders playback
web/src/components/TransmissionCard.tsx - Live transmission feed → Browser API client: loads feed
- Browser API client → FastAPI service: calls API
- Monitor user → Case management UI: manages cases
- Case management UI → Browser API client: requests case actions
- Monitor user → Admin settings UI: changes settings
- Admin settings UI → Browser API client: submits settings
- Voter RSSI → Transmission pipeline: provides RSSI context
squelch/pipeline.py - Live captions → Monitor user: streams provisional text