Add README and LICENSE

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-25 19:38:34 +00:00
parent 5f28a11aa4
commit aac310b29e
2 changed files with 115 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,30 @@
+# SDR Scanner & Recorder
+
+Monitors and records EU CB radio transmissions using an RTL-SDR dongle on a Raspberry Pi 400, powered by [RTLSDR-Airband](https://github.com/charlie-foxtrot/RTLSDR-Airband).
+
+## Monitored Channels
+
+| Channel | Frequency |
+|---------|-----------|
+| CB 3    | 26.985 MHz |
+| CB 7    | 27.035 MHz |
+| CB 10   | 27.075 MHz |
+| CB 16   | 27.155 MHz |
+
+## Architecture
+
+Three Docker containers via `docker-compose`:
+
+- **rtlsdr-airband** — multichannel SDR receiver, splits recordings per-transmission into dated directories
+- **nginx** — web UI for browsing recordings on port 8080
+- **cleanup** — periodically removes short/noise recordings (< 3KB)
+
+## Usage
+
+```sh
+ssh m@sdr-pi
+cd /workspace
+docker compose up -d
+```
+
+Recordings are saved to `~/recordings/` and browsable at `http://sdr-pi:8080`.