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

Downloads & release bundles

PodSDR is distributed as a set of self-contained bundles, one per platform and role. A full release (produced by ./build-all.sh, see Building the bundles yourself) contains:

FileContentsFor
podsdr-proxy-pi-bundle.tar.gzServer bundle, aarch64 LinuxRaspberry Pi 3/4/5 running a 64-bit OS
podsdr-proxy-x86_64-bundle.tar.gzServer bundle, x86_64 LinuxAny 64-bit Linux box (glibc)
podsdr-proxy-macos-bundle.tar.gzServer bundle, universal macOS binarymacOS 11+ (Intel & Apple Silicon)
podsdr-proxy-windows-bundle.zipServer bundle, x86_64 WindowsWindows 10/11 (64-bit)
podsdr-gui-linux-x86_64.tar.gzDesktop GUI64-bit Linux (Ubuntu 20.04 / Debian 11 or newer)
podsdr-gui-macos-universal.tar.gzDesktop GUI as PodSDR.appmacOS 11+ (Intel & Apple Silicon)
podsdr-gui-windows-x86_64.zipDesktop GUI (podsdr-gui.exe)Windows 10/11 (64-bit)
podsdr-android-arm64.apkAndroid apparm64 Android phones/tablets
SHA256SUMS.txtChecksums for all of the aboveVerifying downloads

Verify a download before installing:

shasum -a 256 -c SHA256SUMS.txt      # macOS
sha256sum -c SHA256SUMS.txt          # Linux

What’s inside a server bundle

Every server bundle unpacks to a single directory containing:

podsdr-proxy[.exe]        the proxy server binary
podsdr-emu[.exe]          the Protocol-1 radio emulator
web/                      the browser client the proxy serves
  index.html
  podsdr_web.js
  podsdr_web_bg.wasm
run.sh / run.bat          start the proxy as a LAN web server (HTTPS on :8080)
run-cloud.sh / run-cloud.bat
                          start the proxy with a cloud-broker uplink
                          (plus the LAN web server, unless disabled)
README.txt                a condensed version of this guide

Platform extras:

  • Linux / Raspberry Pi: podsdr-proxy.service — a systemd unit for running at boot (see Running as a system service).
  • macOS: org.podsdr.proxy.plist — the equivalent launchd job.
  • Windows: instructions in README.txt for wrapping the proxy with NSSM as a Windows service.

The emulator is shipped alongside the proxy so you can spin up a virtual radio on the LAN without any extra tooling. It is not started by run.sh or the service unit — you launch it yourself when you want it:

./podsdr-emu --radio hermeslite

What’s inside a desktop GUI bundle

  • Linux: the podsdr-gui binary plus a run.sh launcher.
  • macOS: a signed (ad-hoc) PodSDR.app you can double-click in Finder, plus a run.sh that launches it with the terminal attached so you can see logs.
  • Windows: podsdr-gui.exe plus a run.bat launcher.

Nothing is installed system-wide — each bundle runs from wherever you extract it, and removing the directory removes the program.