SDR-Shark

Hardware-free RF sensing demo with real software depth.

SDR-Shark is a browser-based software-defined radio console packaged as a public-safe Docker demo with synthetic IQ replay, Bluetooth-like frequency-hopping signal behavior, FFT, waterfall, and decoded signal activity workflows.

Open GitHub Run Demo

Portfolio proof

A repeatable SDR workflow reviewers can run without radio hardware.

The public demo generates deterministic synthetic IQ data locally, starts the SDR-Shark backend and frontend, activates replay, and exposes the same browser workflow used for spectrum visualization and signal review. It is designed for public portfolio review without committing real RF captures.

Run the public Docker demo in one command:

docker compose -f docker-compose.demo.yml up --build

What It Demonstrates

Stationary receiver view of a Bluetooth-like frequency-hopping emitter with replay-backed FFT, max-hold, persistence, and waterfall views
Scanner-oriented spectrum workflows and signal activity panels
Python backend APIs for IQ sessions, replay control, and live data
Docker packaging for one-command public demonstration
Integration points for RF classification and gateway-backed SDR deployments

Public demo mode

Deterministic synthetic replay, packaged for Docker.

The demo session uses synthetic 2.4 GHz carriers, moving noise floor, burst activity, and a Bluetooth-like frequency-hopping emitter that moves across a stationary receiver view. It is intentionally synthetic and public-safe; no captured RF environment data is tracked in the repository.

Run It

git clone https://github.com/rtg-engineering/sdr-shark.git
cd sdr-shark
docker compose -f docker-compose.demo.yml up --build

Open http://<machine-ip>:8080 on the local network. Stop it with docker compose -f docker-compose.demo.yml down.

Verify It

curl http://127.0.0.1:8080/api/iq/sessions
curl http://127.0.0.1:8080/api/iq/replay/status
curl http://127.0.0.1:8080/api/data

A healthy demo reports active replay and non-empty FFT and waterfall arrays from the data endpoint.

Live interface

Browser-based spectrum, waterfall, and signal activity views.

SDR-Shark presents RF software as an operator-facing web application: spectrum traces, waterfall history, decoded activity cards, scanner configuration, settings dialogs, and analysis workflows are visible from the browser rather than hidden inside scripts or notebooks.

SDR-Shark public demo showing a Bluetooth-like frequency-hopping synthetic emitter in the spectrum and waterfall interface

Docker demo captures

Fresh screenshots from the synthetic replay workflow.

These images were captured from the public Docker demo using the deterministic public-demo-2p4ghz session. The receiver stays centered while the synthetic Bluetooth-like emitter hops across the passband.

SDR-Shark public Docker demo full dashboard with synthetic RF replay — Full browser dashboard showing stationary receiver state, synthetic carriers, FFT, waterfall, and signal activity context.

SDR-Shark synthetic replay spectrum and waterfall detail — Synthetic 2.4 GHz replay detail with a Bluetooth-like hopping emitter, narrowband carriers, moving noise floor, and waterfall history.

SDR-Shark signal activity side panel from public replay demo — Signal activity panel wired to the same operator interface used for decoded protocol workflows.

Engineering scope

Where this applies.

SDR Prototyping

Prototype receive pipelines, scanner dwell plans, replay tools, dashboards, and integration glue for software-defined radio systems.

RF Data Products

Turn IQ streams, FFT products, detected activity, and metadata into reviewable interfaces and evidence artifacts.

RF/ML Integration

Prepare hooks for classifier workflows, feature extraction, model-backed labeling, and signal-family exploration.

Demo Packaging

Create deterministic, public-safe demonstrations that let stakeholders evaluate a working system without lab hardware.