Wireless AttacksradiosignalssdrspectrogramvisualizationsigMFgnuradio

inspectrum

inspectrum is a tool for visualising captured radio signals, primarily from software-defined radio receivers. It supports analysis through spectrograms, plots, and measurements of various signal file formats.

Description

inspectrum is designed for analysing captured signals from software-defined radio (SDR) receivers. It provides visualization capabilities including spectrograms with zoom/pan, plots of amplitude, frequency, phase, and IQ samples, as well as cursors for measuring period, symbol rate, and extracting symbols. Users can export selected time periods, filtered samples, and demodulated data.

The tool supports a wide range of file types such as SigMF recordings (*.sigmf-meta, *.sigmf-data), complex float formats (*.cf32, *.cfile, *.cf64), integer formats (*.cs16, *.cs8, *.cu8), and real samples (*.f32, *.f64, *.s16, *.s8, *.u8). This makes it versatile for processing outputs from tools like GNURadio, osmocom_fft, BladeRF, HackRF, and RTL-SDR.

Key features include support for large files (100GB+ or multi-gigabyte), making it suitable for handling extensive signal captures in radio frequency analysis and reverse engineering scenarios.

How It Works

inspectrum reads interleaved complex 32-bit float files (e.g., from GNURadio or osmocom_fft) and other supported formats, rendering them as spectrograms with zoom/pan functionality. It generates plots for amplitude, frequency, phase, and IQ samples, allowing cursor-based measurements of signal properties like period and symbol rate. The tool supports exporting filtered or demodulated data from selected time periods, leveraging libraries like FFTW, Liquid, and Qt for signal processing and GUI rendering. The -r flag specifies sample rate in Hz for accurate visualization.

Installation

bash
sudo apt install inspectrum

Flags

-r rateSample rate in Hz.

Examples

Visualizes a complex 32-bit float file (e.g., from GNURadio or osmocom_fft) with spectrogram and plots.
inspectrum file.cf32
Loads SigMF metadata recording for signal analysis.
inspectrum file.sigmf-meta
Analyzes RTL-SDR complex 8-bit unsigned integer file with specified 2.5 MHz sample rate.
inspectrum file.cu8 -r 2500000
Visualizes HackRF complex 8-bit signed integer samples.
inspectrum file.cs8
Processes BladeRF complex 16-bit signed integer samples.
inspectrum file.cs16
Opens GNURadio/osmocom_fft complex file with 10 MHz sample rate for large file analysis.
inspectrum file.cfile -r 10000000
Displays real 32-bit floating point samples in spectrogram view.
inspectrum file.f32
Updated 2026-04-16kali.org ↗