Native macOS receiver for RTL-SDR dongles and SDRplay RSP receivers (Apple silicon), inspired by SDR Console. Swift + SwiftUI, DSP with Accelerate/vDSP, spectrum and waterfall rendered on the GPU with Metal.
brew install librtlsdr # only needed to build/bundle; the .app then ships its own librtlsdr + libusb
./scripts/build-app.sh # → "build/Kymara SDR.app"
open "build/Kymara SDR.app"During development: swift run -c release Kymara. Tests: swift test -c release.
RADE (FreeDV) support is built from sources that are not in this repository (~85 MB of neural network
weights). build-app.sh fetches them; for swift run/swift test, run ./scripts/fetch-rade.sh once first.
Without them Kymara builds without the RADE mode.
The app updates itself with Sparkle (Kymara SDR → Check for Updates…, or
automatically). It reads appcast.xml from the main branch; pre-releases are only offered when Include
pre-releases is on in Settings. Updates installed this way are not quarantined, so macOS only asks for approval
on the first install.
SDRplay RSPs need the official SDRplay API 3.15 or newer for macOS, installed from
sdrplay.com/api. It is closed source, so Kymara cannot bundle it; the app loads it
at runtime from /usr/local/lib and works without it for the other sources. Supported: RSP1, RSP1A, RSP1B, RSP2,
RSPduo (single-tuner mode) and RSPdx/RSPdx-R2. Only the RSP1 has been tested with real hardware so far.
After an SDRplay API upgrade, ./scripts/check-sdrplay-shim.sh checks that Kymara's copy of the API's struct
layouts still matches the installed headers.
Sources: RTL-SDR over USB, SDRplay RSP over USB (16-bit samples), rtl_tcp (network), I/Q files (WAV 8/16-bit/float, raw .cu8) and a
demo generator with FM broadcast, AM, NFM, SSB and CW signals, so everything also works without hardware.
Receiver: AM, NFM, WFM (stereo with a 19 kHz pilot PLL, 50/75 µs de-emphasis), USB, LSB, CW (adjustable pitch) and RADE/RADE2 (FreeDV digital voice V1/V2). Adjustable bandwidth (presets or by dragging the filter edges), tuning step, AGC (off/fast/medium/slow) or manual AF gain, squelch with hysteresis (level, or auto on carrier-to-noise ratio in FM modes), volume/mute.
FreeDV RADE: receives FreeDV's RADE V1 (mode RADE) and V2 (mode RADE2) digital voice: a neural decoder and the FARGAN vocoder turn the OFDM signal back into speech. Shows sync, SNR and frequency offset, and the callsign (V1 sends it at the end of each over, V2 repeatedly during it). The sideband follows the FreeDV convention (LSB below 10 MHz except 60 m, USB above) or can be set by hand. Optionally reports to FreeDV Reporter as a receive-only station (Settings → FreeDV Reporter): your callsign, locator, frequency and an optional message while the radio runs in RADE mode, and the callsigns you decode. The stations on FreeDV Reporter can also be shown in a FreeDV tab of the side panel (current band or all bands, transmitting stations first), with labels on the spectrum for stations that are transmitting or did so in the last 15 minutes; a click tunes to them in the RADE version they use.
RDS (WFM): programme service name, PI code, programme type, TP/TA, RadioText and clock time, with error correction of short bursts. Shown as a panel over the spectrum; new favourites are named after the station.
RF/tuner: sample rate 0.25–3.2 MS/s, RF gain or tuner AGC, RTL AGC, PPM correction, direct sampling (HF), bias-T, offset tuning, DC correction, I/Q swap, overload indicator. SDRplay: 0.25–10 MS/s, LNA state, IF gain or IF AGC, low IF (no DC spike, up to 2.048 MS/s) or zero IF with hardware decimation, and depending on the model antenna or tuner selection, bias-T and FM/DAB/AM notch filters. The S-meter uses the gain reported by the API.
Display (Metal): spectrum with fill, peak hold and max-per-pixel rendering; waterfall with 6 palettes, adjustable speed and levels, which shifts correctly when retuning; FFT 1k–64k, averaging, zoom up to ×256, auto range. S-meter (S1–S9+60, estimated dBm and dBFS, peak and squelch markers). Light, dark or system theme.
Recording: audio (16-bit stereo WAV) and I/Q (8-bit WAV for RTL-SDR, 16-bit for SDRplay, playable as a file source), saved to
~/Music/Kymara Recordings.
Favourites: grouped, filterable, editable.
DX cluster: live amateur radio spots from DXHeat.com, in a tab beside the favourites and as callsign labels on the spectrum (coloured by CW, phone or digital, fading with age). Click a spot or label to tune to it in its mode: CW as reported, digital modes in USB (also when the comment names one, such as RTTY or FT8, or the spot is on a standard FT8/FT4 frequency), and SSB as reported or by the usual sideband convention. Filter by range, mode, DX continent or text. Off by default; when on, Kymara checks for new spots every minute (adjustable in Settings), only while its window is visible.
Settings are saved automatically to ~/Library/Preferences/nl.pa3jh.kymara.plist and survive updates.
Each field is read on its own (missing or unknown → default value), favourites, DX cluster, FreeDV Reporter and FreeDV station list settings are stored under their own keys,
and unreadable data is backed up instead of overwritten.
| Action | Spectrum / waterfall |
|---|---|
| Click | Tune (rounded to the tuning step; ⌥ = exact) |
| Drag the passband | Move the VFO |
| Drag a filter edge | Bandwidth |
| Drag the background | Pan (when zoomed) or move the LO |
| Scroll | Tune by one step |
| ⌘/⌥ + scroll, pinch | Zoom around the cursor |
| ← / → (⇧ = ×10) | Tune; ↑/↓ zoom |
| Right-click | Context menu |
Frequency display: scroll over a digit to change it, click its upper/lower half for +/−,
double-click or type a number (⌘F) to enter a frequency (145.5, 7100k, 1.09G).
Shortcuts: ⌘R start/stop, ⌘1–7 modes, ⌘D add favourite, ⌘=/⌘−/⌘0 zoom, ⇧⌘A/⇧⌘I record, ⌥⌘B/⌥⌘X favourites/DX spots, ⇧⌘L DX spot labels.
Sources/SDRCore— sources (librtlsdr and the SDRplay API viadlopen, rtl_tcp, file, demo), DSP chain (NCO → decimation to ~240 kHz → channel filter (overlap-save FFT) → demodulation → ~48 kHz audio, plus the RDS decoder on the FM multiplex), spectrum analysis, audio output (AVAudioEngine) and recording.Sources/CRADE— FreeDV RADE receiver: a small C wrapper around rade_c, Opus's FARGAN and freedv-backend's callsign decoder (their sources are fetched byscripts/fetch-rade.sh).Sources/CSDRplay— C declarations of the SDRplay API types (no code; the library is loaded at runtime).Sources/Kymara— SwiftUI app,RadioController(state and settings), Metal renderers, persistence, and the DX cluster client (DXCluster/) and FreeDV Reporter client (FreeDVReporter/).
The DSP processes 1 s of 2.4 MS/s in ~15–25 ms on Apple silicon.
Kymara is free software, licensed under the GNU General Public License v3.0. Copyright © 2026 Jorith van den Heuvel.
The app bundle includes these libraries (the RADE ones are compiled in), each under its own license. The license
texts are in Kymara SDR.app/Contents/Resources/Licenses.
| Library | Version | License | Source |
|---|---|---|---|
| librtlsdr | 2.0.3 | GPL-2.0-or-later | v2.0.3 |
| libusb | 1.0.30 | LGPL-2.1-or-later | v1.0.30 |
| Sparkle | 2.10.0 | MIT | 2.10.0 |
| rade_c (RADE V1 and V2 receivers) | c8a3dc1 | BSD-2-Clause | c8a3dc1 + patches |
| Opus (FARGAN vocoder) | 940d4e5 | BSD-3-Clause | 940d4e5 |
| freedv-backend (RADE V1 callsign decoder) | 8018330 | BSD-2-Clause | 8018330 |
| freedv-backend (RADE V2 callsign decoder) | 6053eaa | BSD-2-Clause | 6053eaa |
The SDRplay API is not bundled; it is installed separately under SDRplay's own license.