Skip to content
demian0311Public

About

RTL-SDR receiver for Omarchy: waterfall, FM/AM/SSB, RDS, HD Radio, weather balloon decoding

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Squelch

A receiver for RTL-SDR dongles, built for Omarchy on Hyprland. Plug in a dongle, pick a band, and click a signal on the waterfall to hear it.

Install

On Omarchy (or any Arch), paste this in a terminal:

sudo pacman -S --needed rtl-sdr fuse2
mkdir -p ~/.local/bin ~/.local/share/applications
curl -fL -o ~/.local/bin/squelch https://github.com/demian0311/squelch/releases/latest/download/Squelch-x86_64.AppImage
chmod +x ~/.local/bin/squelch
printf '[Desktop Entry]\nName=Squelch\nExec=%s\nType=Application\nCategories=AudioVideo;\n' ~/.local/bin/squelch > ~/.local/share/applications/squelch.desktop

Plug in the dongle, then start Squelch from the app launcher (Super + Space) or run squelch. To update, run the curl line again.

rtl-sdr lets your user open the dongle. fuse2 lets the AppImage (a single-file Linux app) run. The optional extras and the TV-driver fix below apply here too.

What it does

  • Spectrum and waterfall. Live view of up to about 1.9 MHz around the tuned frequency.
  • Listen. Wide FM, narrow FM, AM, USB and LSB.
  • Finds signals for you. Signals that stand above the noise floor get a card on the waterfall. Click a card to tune to it.
  • Bands and channels. Ready-made bands for broadcast FM, aircraft, NOAA weather, marine, CB, walkie-talkies, railroad, the ham bands and more. CB, FRS, NOAA, marine and US rail channels show their names.
  • FM station data (RDS). Station name, RadioText, and song title and artist where the station sends them.
  • HD Radio. Plays the digital HD channels of FM stations, through nrsc5. This is optional: Squelch still starts without it.
  • EMS. Follows P25 trunked radio, the digital system most US public safety agencies use. Tune a site's control channel and Squelch plays each unencrypted Phase 1 call as the site assigns it. Optional: it needs mbelib.
  • Weather balloons. Decodes the radiosondes that weather services launch twice a day: Graw DFM-06, DFM-09 and DFM-17, and Vaisala RS41.
  • Follows your Omarchy theme. It recolors when you change the theme.

Hardware

Any RTL2832U dongle should work. Squelch was built on one with an R820T tuner, which covers 24–1766 MHz. HF (below 24 MHz) is not supported.

Only one program can use the dongle at a time, so close gqrx or SDR++ first.

Build from source

On Arch:

sudo pacman -S rtl-sdr webkit2gtk-4.1 rust pnpm
git clone https://github.com/demian0311/squelch.git && cd squelch
./run.sh

./run.sh sim starts a simulated receiver, so you can try Squelch with no dongle.

If the kernel's DVB-T TV driver claims the dongle first, blacklist it:

echo 'blacklist dvb_usb_rtl28xxu' | sudo tee /etc/modprobe.d/blacklist-rtlsdr.conf

Then unplug the dongle and plug it back in.

For HD Radio, install nrsc5-git from the AUR, or build nrsc5 and put libnrsc5.so in ~/.local/lib.

For EMS voice, install mbelib:

sudo pacman -S mbelib

To let Squelch wake the computer for a planned time, run this once. It asks for your password:

squelch --setup-wake

If you built from source, the clock form under a bookmark shows the full command to paste. Squelch has to stay open for a plan to run, and whether the alarm wakes the computer depends on the hardware.

EMS

Squelch follows a P25 site from its control channel: the one channel the site keeps on all the time to assign calls to voice channels.

To find a control channel near you:

  1. Open RadioReference, choose your state, and look under "Trunked radio systems" for a P25 system. Each site lists its control channel frequencies.

  2. Or, with Squelch closed, scan for always-on carriers yourself:

    cargo run -p radio --release --example p25_scan -- 3

    Lines with a duty near 100% are likely control channels. Frequencies are as the dongle reads them, so they can be off by a few tens of kHz.

  3. In Squelch, choose Public safety → EMS 700 or 800, and tune the frequency. Squelch searches nearby carriers if the dongle's frequency is a little off.

The EMS panel under the waterfall shows the site and every call it assigns. Encrypted calls and Phase 2 calls (the newer time-slot format) are listed but do not play. How many calls you can hear depends on your area: many cities encrypt.

Squelch plays one call at a time.

Configuration

The band list is in ~/.config/squelch/bands.toml. It is written from the defaults on first start. After that, Squelch only adds groups and bands that newer versions bring; your edits are kept, and anything you delete stays deleted. Edits show up within a few seconds, with no restart.

docs/bands.md describes every field, so you or an AI agent can add your own bands and local repeaters.

Development

cargo test -p radio --release   # engine tests
pnpm test                       # UI tests
pnpm check                      # type check

crates/radio/examples/ has command-line tools that work without the UI. They probe a station, scan for weather balloons or HD Radio, and decode recordings.

License

GPL-3.0-or-later. See LICENSE.

About

RTL-SDR receiver for Omarchy: waterfall, FM/AM/SSB, RDS, HD Radio, weather balloon decoding

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages