The SigMF ("Signal Metadata Format") is a standard format for exchanging digitally-sampled time-series data with JSON-based metadata. It is often used for storing real or complex-valued (IQ) time series data in digital signal processing or software-defined radio applications.
specview is a portable and performant SigMF file viewer and annotation editor.
- Simultaneous time-domain, spectrum, and waterfall (spectrogram) views with linked brushing (simultaneously select time and frequency regions).
- Support for viewing large files (10s of GB) and multiple files -- computation is parallelized in the background.
- Precise annotation of time/frequency regions using cursor selection and/or entering parameters into the table. Arbitrary JSON editing.
- Dockable/Floatable window panes for easy wideband viewing on larger screens.
- Configurable spectrogram/FFT parameters (#bins, window, hop).
- Download the latest release from the Releases page and run the
specviewexecutable directly. - No Python required.
- Available for Linux, Mac, and Windows.
Install the specview package from PyPI using your favorite Python package/tool manager (run any one of the following commands):
pip install --user specviewpipx install specviewuv tool install specviewpixi global install --pypi specview
Requires Python 3.11+ and a working Qt6 environment.
specview [file1.sigmf-meta [file2.sigmf-meta ...]]
Files can also be opened from the File menu after launch. See also specview --help.
To run unit tests:
git clone https://github.com/jeremytrimble/specview.git
cd specview
uv run --group build --group dev poe test
Specview is built on top of numerous open-source projects and proudly released under the GNU General Public License v3.
Built with open-source, copilot, and love.