SpiritBox

Investigation Command Center

An AI-powered paranormal investigation platform that transforms any computer with USB ports into a multi-sensor anomaly detection hub. Local AI voice detection, real-time correlation, and complete evidence archival. Zero cloud. Full privacy.

Early Alpha macOS + Linux C++20 / Qt6 / whisper.cpp
Companion app: SpectraSentry Tactical Skanner — RF spectrum analysis, TSCM, waterfall visualization. Shares drivers and data via IPC bridge.
Signal Processing Pipeline
SweepEngine (SoapySDR) → IQ Samples
    ↓
AudioDemodulator (AM/FM/SSB) → PCM Audio
    ├→ AudioOutputManager (PortAudio) → Speakers
    ├→ VoiceActivityDetector (multi-feature)
    │   ├→ WhisperTranscriber (local AI STT)
    │   └→ EMFCorrelator ← EMFSerialReader (GQ EMF-390)
    │       └→ CorrelatedEvents (EMF + Voice + Transcription)
    └→ SessionRecorder (WAV + JSONL + CSV archival)

USBDeviceManager → SensorHub (command center brain)
Core Features

RF Spirit Box

SoapySDR multi-device abstraction. 6 demodulation modes (AM, NFM, WFM, USB, LSB, RAW IQ). Configurable frequency sweeps with band definitions and dwell times (10-100ms). Pre-built profiles for AM broadcast, FM broadcast, VHF, and full spectrum. Dynamic tuning without stopping sweeps.

AI Voice Detection

Local Whisper.cpp speech-to-text. Zero cloud dependency, complete field privacy. Multi-feature Voice Activity Detection combining RMS energy, zero-crossing rate, and spectral flatness. Confidence scoring (0.0-1.0). Duration gating (100ms minimum). 2-second audio snippet capture for analysis. Async processing via QtConcurrent.

EMF Monitoring

GQ EMF-390 full serial interface. Electromagnetic field (milliGauss), electric field (V/m), and RF power density (mW/cm²). Spike detection with configurable threshold. Rolling 100-sample baseline tracking. 10 readings per second. USB auto-discovery for GQ devices.

Temporal Correlation

Configurable time window (500ms default) for multi-sensor event matching. When an EMF spike coincides with voice detection during a temperature drop, SpiritBox flags it as a correlated anomaly with timestamped evidence. Transcriptions retroactively linked to EMF events.

Session Recording

Complete chain-of-custody evidence archival. WAV audio (full sweep + individual snippets). JSONL event streams for real-time indexing. CSV timelines for spreadsheet analysis. JSON records for transcriptions, anomalies, and correlations. Every reading timestamped and attributed.

Multi-Sensor Hub

Universal sensor abstraction for any USB device. 9 sensor categories: RF, EMF, audio, visual, thermal, environmental, motion, geomagnetic, custom. Hot-plug USB monitoring with auto-discovery and classification. Investigation session state machine (Idle → Configuring → Recording → Paused → Reviewing).

Session Output Format

session_001/
  session.json          — Session metadata
  events.jsonl          — Line-delimited event log (real-time)
  audio_sweep.wav       — Full demodulated audio stream
  emf_timeline.csv      — EMF readings with timestamps
  anomalies.json        — Flagged anomaly records
  transcriptions.json   — Whisper AI transcription results
  correlated_events.json— Multi-sensor correlations
  audio_snippets/
    snippet_0001_12.34.wav
    snippet_0002_45.67.wav
Supported Hardware
DeviceCategoryDetection
RTL-SDR / HackRF / Airspy / SDRplayRF ReceiverSoapySDR abstraction
GQ EMF-390EMF MeterUSB Serial (115200 baud)
Any USB Audio InterfaceAudio CapturePortAudio / CoreAudio
USB CamerasVisual CaptureUSB enumeration
FLIR USBThermalTemperature mapping
Arduino SensorsEnvironmentalUSB Serial (JSON data)
PIR Motion SensorsMotionDigital event detection
MagnetometersGeomagneticBaseline deviation

Companion Platform with SpectraSentry

SpectraSentry and SpiritBox are designed as companion applications. Each handles what it does best:

ComponentSpectraSentrySpiritBox
Primary FocusRF spectrum analysis, TSCMAI voice detection, multi-sensor correlation
GQ EMF-390DeviceIOWorker driverEMFSerialReader driver
Audio DemodRTL-SDR internalAudioDemodulator (AM/FM/SSB)
CorrelationAnomaly detector (RF-focused)EMFCorrelator (multi-sensor)
AINot includedWhisper.cpp local STT
Data StorageSQLite databaseFile-based (WAV/JSONL/CSV)
IPCShared memory ring buffer + Unix domain socket (JSON)
Technology

Core

C++20, Qt6 (Widgets, Multimedia, SerialPort, Charts, Concurrent), CMake 3.21+

AI & Audio

whisper.cpp (local offline STT), PortAudio 19+ (real-time playback), lock-free SPSC audio ring buffer

RF & Sensors

SoapySDR 0.8+ (RTL-SDR, HackRF, Airspy, SDRplay). GQ EMF-390 serial protocol. USB hot-plug discovery.

View on GitHub ← See Companion: SpectraSentry