How altunsumerve/vlf-noise-scout works
VLF Noise Scout is a dual-channel natural-radio receiver and live listening station. Its main workflow takes antenna and reference-probe audio through capture and adaptive noise cancellation, then exposes raw and cleaned MP3 streams to the web interface. The interface also provides a waterfall, recent-audio recording, a lightning map and transmitter results; separate command-line tools diagnose the capture chain and scan known transmitters. The live stream ended in August 2026. Backend flow is supported by sampled source; several interface features and integrations are documented or named in excerpts, but their full implementations were not sampled.
Main entry points: app.js Station interface · server.py HTTP server · audio.py Audio pipeline · transmitters.py Transmitter catalog
Components 22
Receiver and diagnostics
- Dual-channel receiver
hardware/README.md - Sound-card input
- Capture diagnostics
server/tools/probe_check.py - Level monitor
server/tools/canli_seviye.py - Transmitter scan
server/tools/verici_avi.py
Audio backend
- Runtime settings
server/vlf_stream/config.py - Audio pipeline
server/vlf_stream/audio.py - Adaptive cancellation
server/vlf_stream/dsp.py - MP3 broadcast
server/vlf_stream/streaming.py - HTTP server
server/vlf_stream/server.py
Web listening interface
- Station interface
web/app.js - Raw and clean audio
web/app.js - Event waterfall
web/app.js - Recent recording
web/app.js - Lightning map
web/app.js - Transmitter table
web/app.js - Static transmitter list
web/transmitters.json
Transmitter results
- Scan results
data/son_tarama.json - Transmitter catalog
server/vlf_stream/transmitters.py
Other components
- VLF signals
- Listener
- Blitzortung network
Connections 25
- VLF signals → Dual-channel receiver: induces signals
README.md - Dual-channel receiver → Sound-card input: feeds audio
README.md - Sound-card input → Audio pipeline: captures audio
- Audio pipeline → Runtime settings: uses settings
server/vlf_stream/audio.py - Audio pipeline → Adaptive cancellation: processes blocks
server/vlf_stream/audio.py - Audio pipeline → MP3 broadcast: encodes raw and clean
server/vlf_stream/audio.py - HTTP server → Audio pipeline: starts and reports
server/vlf_stream/server.py - HTTP server → MP3 broadcast: routes audio streams
server/vlf_stream/server.py - Capture diagnostics → Sound-card input: tests capture
server/tools/probe_check.py - Level monitor → Sound-card input: monitors levels
server/tools/canli_seviye.py - Transmitter scan → Sound-card input: scans input
server/tools/verici_avi.py - Transmitter scan → Scan results: writes results
README.md - HTTP server → Transmitter catalog: serves results
server/vlf_stream/server.py - Transmitter catalog → Scan results: reads results
server/vlf_stream/transmitters.py - Listener → Station interface: opens station
README.md - Station interface → HTTP server: requests streams
web/app.js - HTTP server → MP3 broadcast: streams MP3
server/vlf_stream/server.py - Station interface → Raw and clean audio: switches channels
web/app.js - Station interface → Event waterfall: renders spectrum
web/app.js - Station interface → Recent recording: records recent audio
web/app.js - Station interface → Lightning map: shows lightning
README.md - Lightning map → Blitzortung network: embeds map data
README.md - Station interface → Transmitter table: renders table
web/app.js - Transmitter table → Transmitter catalog: fetches scan data
web/app.js - Transmitter table → Static transmitter list: falls back to list
web/app.js