sdrmm README

The project's README from github.com/Newspicel/sdrmm. As one markdown file: README.md.

SDR-- logo

SDR--

A software-defined radio application for listening, decoding, and recording. Connect radios, channels, and displays in Patch view, then pin your everyday controls to Rack view.

Run the desktop app with a local SDR, or place the server near your antenna and connect through a browser. Both use the same receiver engine and interface.

A receiver patch with three channels, a speaker, recording, and network IQ output

Install

Download a desktop installer or portable server from GitHub Releases. The installation guide covers macOS, Windows, Linux, Homebrew, Nix, and Docker.

On macOS:

brew tap newspicel/tap
brew install --cask sdrminusminus

For a headless server on macOS or Linux, install sdrmm from the same tap:

brew install sdrmm
brew services start sdrmm

Open http://localhost:8080. For remote access, configure authentication and HTTPS.

Start with an RTL-SDR

  1. Plug in the RTL-SDR and pick it on the Device node. Set the rate to 2.4 MS/s.
  2. Add a WFM channel from + Node and set it to a local FM station.
  3. Wire Device iq to WFM iq, and WFM audio to the Speaker.
  4. Start the Speaker. Press p on a node to pin it to the Rack.

Your first receiver walks through it. Radios covers other hardware.

What it supports

SDR-- is under active development. The decoder catalog shows how well each mode is tested.

Screenshots

These captures use debug-build signal sources and repository IQ fixtures. Regenerate them with cargo xtask screenshots.

Spectrum and waterfall Rack view
Spectrum with the tuned channel marked Three receivers in the rack
FT8 decoding Signal identification
Decoded messages from a recorded 20 m FT8 slot Signal measurements and candidate protocols
Aircraft positions Ship positions
ADS-B aircraft and decoder log AIS position in Hamburg harbour
Slow-scan television Amateur television
Robot 36 SSTV picture 625-line ATV test image
Pager messages Broadcast FM
POCSAG messages with webhook output RDS station name, text, and alternate frequencies

Build and contribute

git clone https://github.com/Newspicel/sdrminusminus.git
cd sdrminusminus
python3 scripts/build-media.py
export FFMPEG_DIR="$(python3 scripts/build-media.py --print-prefix)"
pnpm --dir web install --frozen-lockfile
pnpm --dir web build
cargo run -p sdrmm

Open http://localhost:8080, or run cargo xtask dev --watch and open http://localhost:5173 for hot reload. cargo xtask check and cargo xtask test are the main gates.

The build guide lists prerequisites and every check. Read Contributing and the architecture before a pull request.

Documentation and API

License

Copyright (C) 2026 SDR-- contributors.

Licensed under the GNU General Public License, version 3 or later. Third-party notices and license texts are also available in the app's About panel.

sdrmm (Newspicel/sdrmm)

Searching Database…

327 ·GitHub
这是什么?SDR--(仓库为 sdrmm)是一款软件定义无线电应用,可用于收听、解码和录制无线电信号。你可以在 Patch 视图中把无线电设备、信道和显示器连接起来,然后把常用的控件固定到 Rack 视图。
它是桌面应用,还是在浏览器里用?两者都可以。它既可以在有本地 SDR 的情况下作为桌面应用运行,也可以采用客户端-服务器模式:服务器放在天线附近,你通过浏览器连接——无论哪种方式,接收引擎和界面都是一样的。
我怎么安装它?从 GitHub Releases 下载桌面安装包或便携式服务器。安装指南涵盖 macOS、Windows 和 Linux,以及 Homebrew、Nix 和 Docker;无头服务器可以通过 Homebrew tap 以 'sdrmm' 安装。
我需要专门的无线电设备吗?需要,得有一个 SDR 接收器。快速入门使用采样率为 2.4 MS/s 的 RTL-SDR 电视棒;仓库主题里列出了对 HackRF 的支持,其他硬件可参考 Radios 指南。
它适合日常使用,还是还很粗糙?它仍在积极开发中,各解码器的成熟度不一:项目发布了一份解码器目录,展示每种模式的测试完善程度,所以在依赖某个特定模式之前,先查一下这份目录。
我实际能用它做什么?适合爱好者和折腾族的用途:追踪飞机和船舶、业余无线电、接收寻呼机和传感器信号、接收 SSTV 和业余电视之类的图像——或者只是收听 AM、FM、SSB 和数字语音。
如果服务器放在天线附近,远程访问有保护吗?有,但要你自己配置:项目要求你在服务器上设置身份验证和 HTTPS 才能进行远程访问。
我该怎么搭建第一台接收机?在 Patch 视图中:为你的 RTL-SDR 添加一个 Device 节点(2.4 MS/s),再添加一个调到当地 FM 电台的 WFM 信道,把 Device 的 iq 连到 WFM 的 iq,再把 WFM 的 audio 连到 Speaker,启动 Speaker,然后按 p 把节点固定到 Rack 视图。有一份“Your first receiver”指南会带你走完整个流程。
它不只是收听吧?是的——它内置了扫描、信号识别、相干阵列、测向,甚至无源雷达等无线电工具,并配有频谱、瀑布图和地图显示,展示接收到的内容。
我能录制信号之后再回放吗?可以——它能录制设备 IQ、信道基带和音频,并支持以 SigMF 格式回放录音。
其他工具能控制它吗?可以——它内置了 REST 和 WebSocket API、MCP、网络 IQ 导出以及事件转发等自动化功能。运行中的服务器会在 /api/docs 提供 Swagger UI,在 /api/openapi.json 提供 OpenAPI 规范。
Creator
Newspicel
Size
286.3 MB
Stars
327
Age
2mo
Commits · 90 Days