Mercury is a Digital Radio OFDM protocol for HF broadcast and peer-to-peer ARQ connections with compatible TCP interfaces

★ 384⑂ 61👁 21⑃ 455● 100▤ 32
CGPL-3.0Created 2022-12-07
下载:Mercury 1.9.24Mercury-1.9.24 ↓1.9.242026-11-13
+13
日增长
384
stars
61
forks
21
watchers
455
prs
100
issues
32
releases

README

Mercury — HERMES HF Modem

Mercury is part of the HERMES project
(High-Frequency Emergency and Rural Multimedia Exchange System) by
Rhizomatica, funded by
ARDC and others.

Mercury is a software modem for sending email, files and messages over HF
radio — the kind of link you have when there is no internet, no phone network
and no power grid worth speaking of.

Start here: Getting Started ·
Graphical interfaces · Configuration ·
Docs ·
Mailing list ·
Google Play (Android) ·
App Store (iPhone, iPad)

Help wanted: Apple hardware. We build and test the macOS and iOS apps in a
macOS virtual machine on an Intel PC, so we have never run the arm64 builds
on real Apple hardware with a radio ourselves. Any ARM64 Apple device helps: an Apple
Silicon Mac (M1 or later), an iPhone or an iPad, and any donation is welcome.
Please write to the mailing list
or open an issue.

 What this software does

Mercury turns a single-sideband radio into a data link. It handles the
waveform, the error correction, the retransmissions and the radio keying, and
presents the result to your application as an ordinary TCP connection.

- ARQ data link for point-to-point sessions — a connect/accept handshake, an erasure-coded "carousel" that the receiver drives (Reed-Solomon blocks, so a lost frame is replaced by any other frame of the block rather than resent), and a controlled disconnect, so a file either arrives intact or you are told it did not.
- Adaptive speed — each direction runs on one of seven rungs, from the 32-tone MFSK floor through DATAC15, DATAC4, DATAC3, DATAC1 and DATAC17 up to QAM16C2. It starts on the rung the connect's SNR supports and moves on measured delivery. Control frames ride DATAC16 (and MFSK, or tone patterns, at the floor), so signalling survives when payload cannot.
- Broadcast mode alongside ARQ, with its own framing and TCP ingress port — used for one-to-many traffic and for Reticulum mesh networking.
- VARA-style TCP TNC interface on two sockets (control on the base port, data on base+1), speaking MYCALL, LISTEN, CONNECT, BUFFER, SN, BITRATE, TUNE (a 1 kHz ATU tuning carrier with a hard 60 s unkey timer) and MONITOR (a passive VARA-style monitor that decodes every mode). Existing VARA-aware software can generally talk to Mercury unchanged.
- Runs on the audio hardware you have — alsa, pulse, oss, coreaudio, aaudio, dsound, wasapi, rtp (to hermes-radio-daemon), hl2 (a Hermes-Lite 2 on the network, with no sound card or CAT), plus shm, null, fifo and sock for embedded and test use.
- Keys the radio for you via Hamlib, serial RTS (including DigiRig), or the HERMES shared-memory interface — or stays out of the way and lets your client do it.

Mercury runs on Linux, Windows and macOS, including Raspberry Pi.

On-air compatibility. 1.9.20 and later (the "2.0" architecture) connect
to each other, but not to 1.9.19 or older in either direction: their connect
frames have a packet type of their own (and 1.9.18 and 1.9.19 did not connect
to each other either).

Top issues

Discussions

Latest release

Mercury 1.9.24 v1.9.24 2026-11-13
What's Changed
 carousel: a round M asks about (REQ) is scored as the frames M sent by @pedromessetti in https://github.com/Rhizomatica/mercury/pull/504
 fyne-ui: vendored GLFW takes Wayland touch as the left mouse button (Sailfish taps) by @rafael2k in https://github.com/Rhizomatica/mercury/pull/512
 fyne-ui: vendored GLFW's upstreamTreeSHA follows its tree, so 512 is rebuilt by @rafael2k in https://github.com/Rhizomatica/mercury/pull/513
 arq: the callee lets go when the caller's DISCONNECT ends the call it answers by @pedromessetti in https://github.com/Rhizomatica/mercury/pull/508
 fyne-ui

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON