Skip to content

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

BTHL-SpectraSentry Tactical Skanner

Professional Spectrum Analyzer & Paranormal Investigation Command Center

Beyond The Horizon Labs — BTHLCorp

Features • Hardware • Build • Paranormal Tools • ADS-B Radar • TV Scanning • Documentation


Overview

BTHL-SpectraSentry is a military-grade, 19-tab tactical spectrum analysis and paranormal investigation platform for macOS ARM64. It integrates multiple USB SDR devices, EMF sensors, cameras, and environmental monitors into a unified command center used for live investigation and broadcasting on bthlradio.com.

Built with C++17, Qt6, and GNU Autotools. Signed with Apple Developer ID.

Three Companion Applications

Application Purpose
BTHL-SpectraSentry Tactical Skanner 19-tab spectrum analyzer + paranormal investigation suite
BTHL-SpectraSentryOmeter Environmental BLE sensor monitor (temp, EMF, barometric, humidity)
BTHL-SpiritBox SDR spirit box with AI voice detection (whisper.cpp), EMF correlation

Features

Spectrum Analysis (Tabs 1-5)

Tab Feature Description
Waterfall QOpenGLWidget Spectrogram 60fps scrolling waterfall with bthl-cosmic gradient
Audio Monitor CoreAudio Mic Capture 64-band FFT, waveform zoom, WAV recording, infrasound 19Hz detection
EMF-390 HUD Multi-Sensor Dashboard 3-axis EMF/EF/Gyro with severity-coded gauges and statistics
SDR Tuner Manual Frequency Control Direct frequency entry, gain, sample rate, demod mode
AM/FM Radio Vintage Sangean Dial Smooth needle drag, 20 presets, FM auto-seek, squelch, signal meter

Digital TV Scanning (Tabs 6-8)

Tab Standard Region Channels
Digital TV DVB-T (OFDM) Europe/Asia/Australia 21-69 (474-858 MHz)
ATSC (US) ATSC (8VSB) US/Canada 14-51 (470-698 MHz)
DVB-T2 (EU) DVB-T2 (256-QAM) Newer Europe 21-48 (474-690 MHz)

Each scanner probes UHF channels for signal power and SNR. WATCH button enables RF signal visualization through the decode pipeline (RTL-SDR IQ → leandvb/ffmpeg → display).

ADS-B Aircraft Radar (Tab 9)

Feature Description
Mode S Decoder Custom CRC-24, DF17 Extended Squitter, CPR position decode
PPI Radar Display Rotating sweep beam, range rings, compass rose
Aircraft Tracking Directional chevrons with callsign labels, trail history
Anomaly Detection [NO ID], [DARK], [EMERGENCY], [LOW ALT] flags
Aircraft Intel hexdb.io lookup — registration, type, operator, country, classification
Geographic Features US/Canada/Mexico coastlines, Great Lakes, 100+ airport markers
Navigation Drag-to-pan, pinch/scroll zoom (5-2000 NM), zip code centering

RF Vision Imager (Tab 10)

Electromagnetic visual imager — converts raw IQ data into visual patterns. 4 modes:

  • Amplitude Grid (Ghost Imager) — magnitude → brightness with phase → hue
  • IQ Constellation — I vs Q scatter with phosphor persistence
  • Spectral Heatmap — scrolling frequency × time waterfall
  • Phase Portrait — phase angle → color wheel mapping

Paranormal Investigation Tools (Tabs 11-19)

Tab Tool Method Hardware
Ovilus EMF-to-Word Generator EMF fluctuations → 200+ word dictionary → spoken aloud via macOS TTS GQ-EMF-390
Geophone Vibration Monitor Accelerometer magnitude tracking with threshold alerting MacBook
SLS Camera Skeleton Detector Apple Vision body pose detection with 5 vision modes 4K USB Webcam
REM Pod Proximity Field Detector EMF baseline deviation with 5-level LED alert system GQ-EMF-390
EVP Recorder Audio Anomaly Marker Session recording with auto-mark of energy spikes MacBook Mic
Tesla Field Static Electric Field Mapper EF (V/m) visualization with spike detection GQ-EMF-390 EF
Cold Spot Temperature + EMF Correlation Detects simultaneous temp drops + EMF spikes BLE Sensors + EMF-390
Laser Grid Shadow Detection Camera Grid overlay on darkened feed, frame differencing for break detection 4K USB Webcam
Timeline Multi-Sensor Anomaly Correlation 9-lane scrolling timeline, coincidence detection (3+ sensors = alert) All Sensors

SLS Camera Vision Modes

Mode Effect Use Case
Night Vision Green phosphor amplification Dark room investigation
Thermal View False color heat mapping Cold spot visualization
High Contrast Extreme contrast stretching Shadow figure detection
Edge Detect Sobel edge filter Anomaly silhouettes
Normal Raw camera + skeleton overlay Daylight investigation

Every paranormal tab includes a ? help button with science documentation explaining the physics, detection algorithms, formulas, environmental factors, and best practices.


Hardware

Supported Devices

Device Protocol Connection Range
TinySA4 Ultra SCPI USB serial VID 0x0483/PID 0x5740, 115200 baud 100kHz-960MHz
GQ-EMF-390v2 Binary USB serial VID 0x1A86 (CH340), 115200 baud 3-axis EMF/EF/Gyro
RF Explorer Binary USB serial VID 0x10C4 (CP2102), 500000 baud 15MHz-2.7GHz
Nooelec SMArt XTR v5 (RTL-SDR) librtlsdr USB bulk E4000 tuner 52-2200MHz
WiFi CoreWLAN Always active 2.4/5/6 GHz
Bluetooth CoreBluetooth/IOBluetooth Always active BLE + Classic
USB Webcam (EMEET 4K) AVFoundation USB UVC SLS Camera / Laser Grid

SDR Device Mode Arbitration

The RTL-SDR is single-channel — only one feature can use it at a time. The mode system automatically saves/restores SDR state when switching between:

  • AM/FM Radio ↔ DVB-T Scan ↔ ATSC Scan ↔ ADS-B Tracking ↔ RF Vision

Build

Prerequisites

  • macOS ARM64 (Apple Silicon)
  • Homebrew
  • Xcode Command Line Tools

Install Dependencies

./scripts/install-deps-macos.sh

Or manually:

brew install qt@6 yaml-cpp sqlite fftw pkg-config autoconf automake libtool
brew install librtlsdr soapysdr soapyrtlsdr soapyhackrf soapyremote
brew install ffmpeg gnuradio

Build

autoreconf -fi
./configure
make -j$(sysctl -n hw.ncpu)
make check   # 9 tests
sudo make install

Debug Build

./configure --enable-debug
make -j$(sysctl -n hw.ncpu)

Run

./spectrasentry/.libs/bthl-spectrasentry

Architecture

bthl-spectrasentry/
├── libspectra-core/          Shared C++ library
│   ├── include/              Config, DB, logging, signal processing, IPC, metrics
│   └── src/                  14 implementation files
├── spectrasentry/            Tactical Skanner (65+ source files)
│   ├── include/              All widget and device headers
│   ├── src/                  Devices, graphics, SDR, TV, ADS-B, paranormal tools
│   └── resources/            QSS themes, GLSL shaders, Qt resources
├── spectrasentryometer/      Environmental Sensor Monitor (19 source files)
├── configs/                  YAML configs, profiles, frequency databases
├── sql/migrations/           7 database schema migrations
├── tests/                    9 unit tests
├── installer/macos/          Code signing, pkg, dmg scripts
├── docs/                     7 technical documentation files
└── scripts/                  Build helper scripts

Key Technologies

  • C++17 with Qt6 (Widgets, OpenGL, SerialPort, Bluetooth, Multimedia)
  • GNU Autotools build system (mandatory)
  • FFTW3 signal processing
  • librtlsdr + SoapySDR for SDR hardware
  • Apple Vision framework for body pose detection
  • AVFoundation for camera capture
  • CoreAudio AUHAL for mic capture and audio output
  • CoreWLAN / CoreBluetooth / IOBluetooth for wireless scanning
  • SQLite3 database (WAL mode) with 7 migrations
  • yaml-cpp configuration with K8Scape-style schema

Paranormal Investigation Science

Each tool includes built-in science documentation (? button). Key principles:

Principle Application
Electromagnetic Field Theory EMF fluctuations as potential entity communication (Ovilus, REM Pod)
Thermodynamic Energy Transfer Cold spots from hypothesized entity energy draw (Cold Spot Detector)
Infrasound (19 Hz) "Fear frequency" detection — causes unease below human hearing
Multi-Sensor Fusion 3+ sensors triggering simultaneously reduces false positive probability
Computer Vision Pose Detection Neural network body shape recognition regardless of visibility (SLS Camera)
Frame Differencing Detecting movement/shadows through pixel comparison (Laser Grid)
RF Signal Visualization Electromagnetic energy rendered as visible patterns (RF Vision)
Skinwalker Ranch 1.6 GHz Documented anomalous frequency monitored with dedicated presets

Skanning Profiles

Profile Focus Alert Level
Ranch Mode 1.6 GHz Skinwalker anomaly Critical at -60 dBm
Ground Radar GPR frequencies (10-400 MHz) Warning at -45 dBm
Full Spectrum Sweep Maximum device range Anomaly detection only
Anomaly Watch All Skinwalker + rogue + ISM Aggressive low thresholds
Rogue Device Hunt TSCM counter-surveillance Emergency on spy devices

Investigation Profiles

Profile Tools Enabled
Full Tactical All tabs active
Skinwalker Ranch 1.6 GHz + EMF + Ovilus + Timeline
Ghost Hunt SLS + Ovilus + REM Pod + EVP + Laser Grid
TSCM Sweep Rogue Detection + Full Spectrum + WiFi/BT
Quick EMF EMF-390 HUD only
Audio EVP Audio Monitor + EVP Recorder

Rogue Device Detection (TSCM)

Category Frequencies Detection Method
Spy Cameras 900 MHz, 1.2/2.4/5.8 GHz Power threshold monitoring
Spy Microphones VHF 130-175 MHz, UHF 400-512 MHz Signal pattern matching
Evil Twin WiFi 2.4/5 GHz SSID + OUI anomaly detection
Rogue Bluetooth 2.4 GHz ISM Device class + vendor analysis

Documentation

Document Description
docs/GRAPHICS_PIPELINE.md Waterfall, 2D/3D spectrum, live trace, shaders
docs/HARDWARE_SETUP.md Device connections, protocols, troubleshooting
docs/ROGUE_DETECTION.md TSCM detection engine, frequency databases
docs/SKANNING_PROFILES.md Profile YAML schema, built-in profiles
docs/SKINWALKER_PRESETS.md Skinwalker frequencies, Solfeggio, Schumann
docs/IPC_PROTOCOL.md Inter-process communication protocol spec
docs/DATABASE_SCHEMA.md SQLite schema, 7 migrations

External Dependencies

Tool Purpose Install
leandvb DVB-T COFDM demodulation Build from github.com/pabr/leansdr
ffmpeg Video decode pipeline brew install ffmpeg
GNU Radio ATSC decode (future) brew install gnuradio
whisper.cpp AI speech-to-text (SpiritBox) Clone to lib/whisper.cpp

Contributing

This is a BTHLCorp project.


License

Copyright (c) 2026 BTHLCorp — Beyond The Horizon Labs. All rights reserved.

Credits

  • David St. John — Project Lead, BTHLCorp
  • Claude Opus 4.6 — Architecture & Code Generation
  • Open source: Qt 6, yaml-cpp, SQLite3, FFTW3, librtlsdr, SoapySDR, leansdr, FFmpeg, whisper.cpp

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages