Rhizomatica /mercury
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
+13
Daily
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
#554If Mercury want to be the winner, act now!16 comments · 2026-11-14#550Fyne-ui and pulse - mercury-ui9 comments · 2026-11-13#529Carousel: after an unconfirmed fall-back onto the floor, blind MFSK rounds cost ~2 min while the peer listens on the rung above6 comments · 2026-11-11#527Winlink / RMS Trimode server integration6 comments · 2026-11-11#506compression: optional payload compression on the carousel, negotiated like #410's crypto bit4 comments · 2026-11-09#495Caller waits out an empty response slot (~7 s after each keydown) before keying host data4 comments · 2026-11-08#392Connection abruptly killed with 'rx_disconnect' after transmission complete, but before winlink message is actually sent4 comments · 2026-10-15#481Real Time Audio thread scheduling enhancement2 comments · 2026-11-06
Discussions
#555If Mercury want to be the winner, act now!3 comments · 2026-11-14#553A heartbeat for Mercury0 comments · 2026-11-14#532Feature Request: Multi-RX Diversity Combining1 comments · 2026-11-12#518Winlink via MERCURY -- YouTube/Advocacy0 comments · 2026-11-10#404Feature Request: Transmit-MFSK-Only Option2 comments · 2026-10-19#402Feature Request: Print more data decoded from messages that are not directed to the user1 comments · 2026-10-18#372Android version on the roadmap?4 comments · 2026-10-12#331Mercury on 2 m FM0 comments · 2026-09-29
Latest release
Mercury 1.9.24 v1.9.24 2026-11-13What'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