openRig

Any Radio, Any Mode, Anywhere!

openRig is a suite of open source tools for ham radio — from a custom Linux distro for hotspots and remote rigs to full-featured logging and control apps.

Get Started View on GitHub ♥ Support on Patreon

Walkthrough Video

A full walkthrough of openRig — from flashing the OS image to getting your hotspot on the air.

Everything you need,
nothing you don't

Built by hams for hams. openRig focuses on reliability, simplicity, and a modern experience across all your devices.

📡

Hotspot Support

Run YSF and DMR hotspots on Raspberry Pi hardware with a clean web interface and reflector management. YSF is fully tested; DMR support is in active development.

🖥️

Remote CAT Control

Control any hamlib-compatible rig over the network. openRigOS turns a Raspberry Pi into a headless CAT controller discoverable via mDNS.

📱

Mobile & Desktop Apps

Native apps for macOS, Windows, Linux, iOS, and Android. Log QSOs, watch DX spots, control your rig — all from one place.

🔌

ConnectRPC API

A modern gRPC/Connect API on every device. Build your own integrations or use the official apps — the choice is yours.

🔍

Auto-Discovery

openRig devices advertise themselves over mDNS. Your apps find them automatically — no IP addresses to remember.

🛠️

Open Source

Every line of code is open. Fork it, extend it, contribute back. Licensed under MIT.

Four projects, one ecosystem

Each component works standalone or together as a complete ham radio station stack.

🐧

openRigOS Linux

A custom Debian-based Linux distribution for Raspberry Pi and x86 hardware. Supports hotspot, remote rig CAT control, and console workstation roles. Includes a built-in web UI for provisioning and management — no monitor required.

Raspberry Pi Zero 2W RPi 4 / 5 x86_64 YSF ✓ DMR hamlib
🖥️

openRigConsole Desktop

A full-featured desktop logging and rig control application for macOS, Windows, and Linux. Features a three-zone layout with rig control, QSO entry, DX cluster spots, bandmap, and station log.

macOS Windows Linux ADIF DX Cluster QRZ
📱

openRigMobile Mobile

A native mobile app for iOS and Android. Log contacts, monitor DX spots, control your rig, and manage openRig devices — all from your phone.

iOS Android Flutter
📦

openrig_core Library

The shared Dart library powering both Console and Mobile apps. Includes hamlib FFI bindings, rigctld TCP client, DX cluster client, ADIF read/write, mDNS discovery, DXCC lookup, and more.

Dart Pure Dart hamlib FFI rigctld mDNS

Get openRig

Choose what you need — the OS image for your Raspberry Pi hardware, the desktop app for your computer, or both.

🐧

openRigOS

For Raspberry Pi & x86 hardware

Flash to a microSD card and run on your Pi. Supports hotspot, remote rig CAT control, and console roles.

Checking for latest release…
⬇ Download Image Get RPi Imager
🖥️

openRigConsole

For your Mac or Windows PC

Full-featured desktop logging and rig control app. Log QSOs, watch DX spots, and control your rig.

Checking for latest release…
macOS Windows All releases ↗

Linux: build from source — openRigConsole repo, requires Flutter 3.x.

Flash & go

Get openRigOS running on your hardware in minutes.

1️⃣

Download & Flash

Download the openRigOS image for your board from the Download section, then flash it to a microSD card with Raspberry Pi Imager using Choose OS → Use custom.

⬇ Go to Downloads
2️⃣

Boot & Connect

Insert the SD card into your Raspberry Pi and power it on. openRigOS will broadcast a WiFi hotspot named openRig-XXXX on first boot, where XXXX is the last 4 characters of the device's MAC address.

Connect to it, then open http://openrig-config.local in your browser to begin provisioning.

3️⃣

Provision Your Device

The built-in web wizard walks you through setting your callsign, WiFi, device type (hotspot, remote rig, or console), and any mode-specific settings.

Once provisioned, the management interface is always available at http://<hostname>.local.

YSF / DMR Hotspot Quick Start

Get your MMDVM_HS_Hat hotspot on the air with openRigOS. You can run YSF, DMR, or both — enable whichever modes suit your radio.

✓ YSF fully tested  ·  YSF (Yaesu System Fusion) is the recommended starting point — it is the only mode that has been completely tested end-to-end at this stage. DMR is supported in the firmware and UI but has seen less testing. Neither mode is required; enable what works for your radio.

What You Need

Hardware
  • Raspberry Pi Zero 2W
  • MMDVM_HS_Hat (duplex or simplex)
  • microSD card (8 GB+)
  • USB-C power supply (5V / 2.5A+)
  • UHF antenna (SMA)
Accounts
  • Amateur radio licence with callsign
  • For YSF: a free account on your chosen YSF reflector network (e.g. YSFReflector.com)
  • For DMR: RadioID.net DMR ID + BrandMeister account
  • QRZ XML subscription (optional, for map)
On Your Computer

Setup Steps

1
Flash the image

Download the Raspberry Pi Zero 2W image from the Get Started section. Open Raspberry Pi Imager, choose Use custom, select the .img.xz file, and flash to your microSD card. No pre-configuration needed.

2
Assemble and power on

Seat the MMDVM_HS_Hat on the RPi Zero 2W GPIO header. Attach the UHF antenna. Insert the flashed SD card. Apply power via the USB-C port. The first boot takes about 60 seconds.

3
Connect to the provisioning AP

On your phone or PC, join the WiFi network openRig-XXXX (password: openrigsetup). Then open http://openrig-config.local in your browser. Alternatively connect via USB cable — the device appears as http://openrig.local.

4
Provision the device

Fill in the provisioning wizard:

  • Device type — select Hotspot
  • Callsign — your licence callsign
  • DMR ID — your 7-digit ID from RadioID.net
  • WiFi — your home network SSID and password
  • Password — sets the SSH / management password

Click Provision Device. The hotspot will connect to your WiFi and restart. Reconnect your computer to your normal WiFi.

5
Configure your mode(s)

Browse to http://<hostname>.local/hotspot (e.g. http://w1aw-hotspot.local/hotspot). On the Hotspot tab, set your RF frequency first, then enable the mode(s) you want:

  • Set RF Frequency (e.g. 438.8000 MHz) and TX offset if duplex
  • YSF — enable YSF and select a reflector. Recommended starting point; fully tested.
  • DMR — enable DMR, choose network (BrandMeister or DMR+), enter your hotspot security password. Requires a DMR ID (see Accounts above).
  • Click Save Hotspot Config
6
Connect to your network

YSF: Your hotspot links to the selected reflector automatically when the config is saved — no account registration required. You can change or unlink the reflector at any time from the Status tab.

DMR (if enabled): Log in to brandmeister.networkSelf Care → Hotspots. Add a hotspot with your DMR ID and set the security password to match what you entered in openRig. The hotspot should connect within a minute.

On the air!

The Status tab shows live last-heard activity and plots callers on the map. Program your radio to your hotspot frequency, key up, and you should see your callsign appear in the heard list within seconds.

YSF: Set your radio to DN mode, dial in your hotspot frequency, and transmit. DMR: Set time slot 2, colour code 1.

Tips & Notes

Frequency choice

Use a simplex frequency in the 70cm (430–440 MHz) band that is clear of local repeaters. Check your regional band plan. Keep RF power low — hotspots are personal devices for home/portable use.

Management interface

The full management UI is always at http://<hostname>.local/hotspot. Use the Device tab to back up your config, update credentials, or export settings for a replacement unit.

SSH access

SSH is always enabled: ssh openrig@<hostname>.local using the password you set during provisioning. Useful for diagnostics and log viewing.