Repository navigation
Getting Started
This walks you from a freshly-installed app to a connected radio, ready to receive and (if licensed) transmit.
Need the app first? See Installation.
Bluetooth pairing is done in your operating system's Bluetooth settings, not in the app:
- Linux: open your desktop's Bluetooth settings, power on the radio, make it discoverable, and pair.
- macOS: System Settings → Bluetooth, then pair.
You only do this once. The app will not pair the radio for you.
- Launch HTCommander.
- Pick your radio in the Radio dropdown (top bar) and click Connect.
- The radio panel shows battery + live status; the log shows the BlueZ / GAIA (macOS: IOBluetooth) transport traffic.
If connecting fails with a key/bonding error, remove the pairing in your OS and re-pair — a stale bond is the usual cause. If it can't find the radio's data channel, toggle the radio's Bluetooth off/on. More in Troubleshooting.
Open the Station tab and set:
- Callsign and Station ID (SSID)
- Allow-Transmit — flip this on only when you intend to transmit
- Winlink password — if you'll use Winlink mail
Transmit is gated on callsign + Allow-Transmit. With either unset, the app will not key the radio. See Transmitting and Safety.
If you'll do APRS, Winlink, or BBS:
- Go to Channels → Load all banks so every memory channel is known.
- Pick your APRS channel in the APRS setup.
On the Benshi UV-PRO, the radio's "Digital mode" must be OFF to use the app/TNC (KISS) path — that's Winlink, BBS, and the App-TNC APRS beacon.
Digital mode is only for the radio's built-in beacon and it disables the TNC. The two are mutually exclusive. If packet features "never connect," check this first.
- Receive APRS and watch stations populate the Map.
- Hold PTT on the Voice tab to talk (once Allow-Transmit is on).
- Explore the rest of the tabs — see Features for the full tour.
73! 📡
Cross-platform (Linux/macOS) port of Ylianst/HTCommander by Ylian Saint-Hilaire · Apache 2.0 · 📡 73!
Getting started
Using the app
Developers