Share radios, audio, and station resources over a network.
RustyRig is a GPLv2-licensed, open-source, multi-user amateur-radio platform. Operate radios from another computer, listen with friends, or bring multiple stations together. Operators get live radio controls, audio, chat, and access to the resources they are allowed to use.
RustyRig is under active development. The current releases are for testing; features and configuration can change.
WebUI will be returning in v2.0! The v1.x series is focusing on improving transport reliability by adding RTP (done!), mesh server links (almost done), and multihome client connections (pending).
Currently this is NOT usable out of the box on non-linux hosts, we'll revisit that soon with libmongoose!
- Operate together. Join radio rooms, see who's online, chat, and coordinate transmitter access.
- Control more than one radio. Work with supported Hamlib radios and networked rig-control backends.
- Listen and transmit remotely. Route receive and transmit audio over the network, with codec selection and per-stream controls.
- Choose your interface. Use the Linux GTK desktop client, terminal client, or browser interface.
- Connect stations. Link servers to access authorized remote rooms and station resources.
- Explore SDR receivers. Browse and connect to supported remote receivers through the SDR Directory.
Additional tools include remote serial/GPS access, audio recording, administration, and station resource discovery.
| Desktop client | Terminal client |
|---|---|
 |
 |
| Settings | Browser client |
|---|---|
 |
 |
| SDR Browser | SDR Receiver |
|---|---|
 |
 |
RustyRig currently targets Debian-family Linux distributions for building and packaging.
git clone --recurse-submodules https://github.com/PripyatAutomations/rustyrig-fw.git
# Install librustyaxe-dev, librrprotocol-dev and librustyirc-dev separately before building.
cd rustyrig-fw
./install-deps.shThe dependency helper prints the installation command for your selected build profile. Follow the instructions it produces, then continue with the quickstart to build, configure a station, and connect your first client.
New to RustyRig? Start with a single server and one radio—or Hamlib's dummy backend—before enabling additional stations or transmit functions.
| Guide | When to read it |
|---|---|
| Quickstart | First installation, login, and connection |
| Operator guide | Tuning, audio, rooms, SDRs and troubleshooting |
| Installation and packaging | Package and service installation |
| Radio rooms | Multiple rigs, room access, and VFO/audio behavior |
| Audio codecs | Selecting codecs and setting up audio pipelines |
| IRC client settings | Multiple connections and proxies |
| Serial devices, server exports and privileges | Map physical UART/USB devices, grant per-device access, attach from clients, and understand mesh limitations |
| Known issues | Open RC problems and requested fixes |
| Changelog | Recent changes and known transitions |
| RC release checklist | Build, package, smoke-test and tag a release |
| Release packaging guide | Debian RC versions, reproducible builds and upgrades |
| Debian archive readiness | Sponsor-facing blockers, license inventory and clean-build checks |
| Debian source/package split | External library source packages and retained rrserver/rrclient/rrbridge binary split |
| Server maintenance | Confirmed database, log, recording and identity resets |
| Remote SDR architecture | Design proposal, not implemented functionality |
Configuration examples live in config/. Use /help in the client for commands.
This is an early version, especially backend.yaesu -- please don't use it unattended until you test it thoroughly in your setup.
CAT emulator currently has very limited 991a support and you probably should select ft891 in your program for now if trying to use it.
Yaesu backend has experimental support for ft991(a) support. If it doesnt work well, let me know and in the meanwhile try hamlib backend.
The main pieces are rrserver (server), rrclient (GTK/TUI), rrbridge (SDR bridges), librrprotocol (shared protocol), librustyaxe (application support), and fwdsp / libfwdspmgr (audio). The browser UI is developed in rustyrig-www.
Contributions, hardware compatibility reports, documentation improvements, and reproducible bug reports are welcome. See the issue tracker.
RustyRig-owned code is licensed under the GNU General Public License,
version 2 only (GPL-2.0-only); see doc/LICENSE.
The independently installed librrprotocol library is GPLv2. The librustyaxe library retains
its MIT license. Other bundled components, dependencies and Windows themes
retain their respective upstream licenses.
For a complete mesh bootstrap or post-compromise credential rotation, see the cluster rebuild and breach-recovery runbook.