Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Install

Pick the desktop app when the radio is plugged into your computer. Pick the server when the radio sits somewhere else and you connect from a browser. Both run the same receiver.

InstallationBest for
Desktop appA radio on your computer
Portable serverA Raspberry Pi, home server, or remote receiver
HomebrewmacOS or Linux with Homebrew
WinGetWindows
APTDebian and Ubuntu
DNFFedora
AURArch Linux
NixLinux managed with Nix
ContainerDocker

Desktop app

Download the installer from the download page and open SDR--. The app starts its own server on a random port only this computer can reach. For a fixed port or access from other devices, run the server instead.

PlatformPackage
macOS.dmg for Apple silicon or Intel
Linux.deb, .rpm or .AppImage for x86-64 or ARM64
Windows.msi or .exe for x86-64, .exe for ARM64

Portable server

Download and unpack the sdrmm archive for your system from the download page, then run it:

./sdrmm

On Windows, run sdrmm.exe. Open http://localhost:8080 on the server, or http://<server>:8080 from another computer.

The server listens on every network interface with no password. Set up a token and HTTPS before untrusted devices can reach it.

Homebrew

brew install newspicel/tap/sdrminusminus   # macOS desktop app
brew install newspicel/tap/sdrmm           # server, macOS or Linux
brew services start sdrmm

The cask installs into /Applications. The service starts the server at login. Open http://localhost:8080.

WinGet

winget install Newspicel.SDRminusminus

APT

curl -fsSL https://newspicel.github.io/packages/key.gpg \
  | sudo tee /usr/share/keyrings/sdrminusminus.gpg > /dev/null
echo "deb [signed-by=/usr/share/keyrings/sdrminusminus.gpg] https://newspicel.github.io/packages/deb stable main" \
  | sudo tee /etc/apt/sources.list.d/sdrminusminus.list
sudo apt update
sudo apt install sdrminusminus

APT and DNF install the desktop app. For the sdrmm server, use the portable server.

DNF

sudo dnf config-manager addrepo \
  --from-repofile=https://newspicel.github.io/packages/rpm/sdrminusminus.repo
sudo dnf install sdrminusminus

AUR

yay -S sdrminusminus-bin   # desktop app
yay -S sdrmm-bin           # server

Nix

Install and launch the desktop app on x86_64 or aarch64 Linux:

nix --extra-experimental-features 'nix-command flakes' \
  profile install github:Newspicel/sdrminusminus
sdrmm-desktop

The flake exports the package as sdrmm-desktop, sdrmm, and default. From a checkout, nix build produces result/bin/sdrmm-desktop.

The Nix package reaches local radios through SoapySDR. Pick the modules with soapyPlugins. This NixOS example assumes the flake input is named sdrminusminus:

environment.systemPackages = [
  (inputs.sdrminusminus.packages.${pkgs.stdenv.hostPlatform.system}.sdrmm.override {
    soapyPlugins = with pkgs; [ soapyrtlsdr soapyremote ];
  })
];

hardware.rtl-sdr.enable = true;
users.users.your-user.extraGroups = [ "plugdev" ];

Container

On Linux:

git clone https://github.com/Newspicel/sdrminusminus.git
cd sdrminusminus
docker compose up -d

Open http://localhost:8080. Data lives in the sdrmm-data volume. For USB radios, tokens, and HTTPS, see Deployment.

Stable or nightly

Use a stable release. The desktop app checks for stable updates at startup and never moves to a nightly on its own. The nightly release follows main and may change saved data without a migration.

Next