Scanner Map

A real-time mapping system for radio calls.
Ingests calls from SDRTrunk, TrunkRecorder, or any rdio-scanner compatible endpoint, then:

• Transcribes audio (local or cloud AI)
• Extracts and geocodes locations
• Displays calls on an interactive map with playback and Discord integration

---

🔥 Recent Updates

• Admin-restricted marker editing — Map marker editing now locked behind admin user when authentication is enabled
• Purge calls from map — New admin-only feature to remove calls by talkgroup category and time range, includes undo button to restore accidentally purged calls
• Full one-command integration (no multiple terminals)
• Auto-generated API keys & admin users
• Improved AI summaries & Ask AI features
• New S3 audio storage option
• OpenAI transcription prompting — configure custom prompts in .env to fine‑tune transcription behavior
• Two-tone detection — powered by icad-tone-detection.
  • Detects fire/EMS tones in radio calls
  • Optionally restrict address extraction to toned calls only, or combine tone + address detection for greater accuracy
• ICAD Transcribe integration — thanks to TheGreatCodeholio/icad_transcribe for providing advanced radio-optimized transcription support

---

✨ Features

🚀 Core

• One-command startup: node bot.js
• Automatic setup: database, API keys, talkgroups, admin accounts
• Integrated services: Discord bot + webserver run together

🗺️ Mapping

• Real-time calls displayed on a Leaflet map
• Marker clustering, heatmaps, day/night/satellite views
• Call details with transcript + audio playback
• Call filtering and marker editing (admin-restricted when auth enabled)
• Call purging: Admin-only bulk removal with undo functionality

🎤 Transcription

• Local: faster-whisper (CPU or NVIDIA GPU)
• Remote: via speaches or custom servers
• OpenAI Whisper API with support for custom prompts
• ICAD Transcribe for radio-optimized results

🤖 AI Enhancements

• Address extraction + geocoding (Google Maps or LocationIQ)
• AI summaries of recent transmissions
• "Ask AI" chat about call history
• Optional two‑tone detection for toned call filtering

🎮 Discord Integration

• Auto-post transcriptions by talkgroup
• Keyword alerts
• AI summaries with refresh buttons
• Optional: live audio in voice channels

🔒 Security

• Optional user authentication
• Auto-generated API keys
• Secure session management
• Admin-only controls for sensitive operations

---

📦 Installation

Supports Windows 10/11 and Debian/Ubuntu Linux.
Installation scripts handle dependencies, configuration, and setup.

Prerequisites

• SDRTrunk, TrunkRecorder, or rdio-scanner configured
• Talkgroup export from RadioReference (Premium subscription recommended)
• API key for Google Maps or LocationIQ
• (Optional) NVIDIA GPU for local transcription
• (Optional) Discord Bot application
• (Optional) Remote transcription server (e.g., speaches or ICAD)

Quick Start

# Linux
sudo bash linux_install_scanner_map.sh

# Windows (PowerShell as Admin)
.\install_scanner_map.ps1

Then:

cd scanner-map
source .venv/bin/activate   # Linux
node bot.js

---

⚙️ Configuration

All main settings are in .env. Key options:

• DISCORD_TOKEN — your bot token
• Maps_API_KEY / LOCATIONIQ_API_KEY — geocoding provider
• MAPPED_TALK_GROUPS — talkgroups to monitor
• TRANSCRIPTION_MODE — local, remote, openai, or icad
• STORAGE_MODE — local or s3
• OPENAI_PROMPT — (if using OpenAI) provide a custom transcription prompt
• ENABLE_TONE_DETECTION — enable/disable two‑tone detection

Other files to edit:

• public/config.js ← map defaults (center, zoom, icons, etc.)
• data/apikeys.json ← auto-generated on first run

---

📡 Connecting Your Radio Software

• SDRTrunk: Configure Streaming → Rdio Scanner endpoint
• TrunkRecorder: Add an uploadServer entry pointing to http://<server>:<port>/api/call-upload
• rdio-scanner downstream: Add server + API key

---

💻 System Requirements

• OS: Windows 10/11 or Debian/Ubuntu
• CPU: Modern multi-core
• RAM: 16GB+ recommended
• GPU: (Optional) NVIDIA CUDA (8GB+ VRAM recommended)
• Storage: SSD (5—10GB for models + audio)

---

🛠 Troubleshooting

• Logs: combined.log and error.log
• Check .env values (especially API keys and modes)
• Verify dependencies: Node, Python, FFmpeg, CUDA (if using GPU)
• Ensure correct geocoding.js (Google vs LocationIQ)

---

🤝 Contributing

Pull requests and issue reports are welcome.

📬 Support

• Open a GitHub Issue
• Contact poisonednumber on Discord