Ratspeak
Ratspeak is the desktop and mobile app for messaging over Reticulum. It combines private LXMF conversations, attachments, Offline Inbox, Channels, experimental voice calls and turn-based games with controls for the interfaces that carry them.
Private LXMF messages are encrypted to the recipient. Channels use a different model: the hub can read and relay room messages. See Messaging and contacts before choosing a room for sensitive conversations.
Get the app
The current public desktop/Android release is 1.1.0. Use the downloads page or the versioned GitHub release. iOS is available through the public TestFlight channel; check TestFlight for its offered build.
| Platform | Release packages | RNode connections in the app |
|---|---|---|
| macOS | Apple Silicon and Intel DMG | USB serial, BLE, TCP |
| Linux | amd64/arm64 DEB; x86-64 AppImage and RPM | USB serial, BLE, TCP |
| Windows | x64 EXE and MSI installers | USB serial, BLE, TCP |
| Android | arm64, armv7 and x86-64 APK | Supported USB host RNodes, BLE, TCP |
| iOS | TestFlight | BLE and TCP |
Bluetooth roles, background behavior and device permissions differ by platform. For installation and first launch, follow Install and platform setup. For radio requirements, use LoRa radio interfaces.
Inside the app
The desktop sidebar lists every view. On a phone, the tab bar holds Peers, Messages, and Channels, and More holds the rest:
- Home, on desktop, shows recent messages and peers, with New message, Add connection, and Announce.
- Messages and Contacts hold conversations and saved peers. Messages include delivery state, attachments, search, formatting, and more than one conversation with the same person.
- Channels connect to a hub and its rooms. Joining, moderation and room access are separate from private LXMF delivery.
- Games provides Chess, Tic-Tac-Toe, and Four in a Row through LRGP.
- Peers shows discovered messaging peers. An old announce or saved contact does not establish a current path.
- Network maps your connections, with every way to connect in one Connectivity panel. Pause all stops them at once.
- Activity shows what Ratspeak is doing on the network and explains problems in plain words.
- Identity holds your identities, with the recovery phrase, PIN, and export.
- Settings covers sending, appearance, notifications, privacy and blocking, network policy, Offline Inbox, and storage.
- Setup handles the initial identity and backup.
A fresh app starts without a network interface. Turn on a path that fits your setup: local LAN discovery, a reachable internet server, a nearby Bluetooth Peer, or an RNode radio. Start with Choosing your setup.
Voice calls
Calls use rsLXST over a Reticulum Link and are experimental. A call can start from a conversation, contact or peer detail when the voice feature is available. A saved contact is not an outbound-call requirement.
Incoming calls are admitted for a saved contact or a direct zero-hop peer, subject to blocking and the call policy. A routed stranger cannot ring you merely because they know your address. Calls need a live path and suitable audio permissions; they are not delivered through Offline Inbox. Losing the Link's interface can end a call.
See Voice calls for controls, microphone permissions, caller policy and current limits. This app behavior is narrower than everything the rsLXST library can support.
Identity and local data
Back up a new software identity's 12-word recovery phrase or export an encrypted .rsi identity backup. The phrase restores the identity, not its message history. A PIN protects the local software identity key and phrase; it does not encrypt the message database or attachment files.
Desktop builds also provide experimental YubiKey/PIV identities through Ratkey. Hardware-only and recoverable provisioning have different backup properties. Use Settings and identity for the app's supported flows.
App state lives under .ratspeak/ in the OS app-data directory. Active Reticulum configuration normally belongs to the selected identity at identities/<identity_hash>/reticulum/config; RATSPEAK_RNS_CONFIG_DIR can override it. See Configuration reference for exact platform paths and storage scope. Use the app's export/import controls for identity transfer; copying an arbitrary key file is not a history migration procedure.
Operators and developers
You do not need a separate rnsd-rs or lxmd-rs installation for ordinary app use. For an always-on transport node, Offline Inbox node or Channels hub, follow Infrastructure and ops.
Ratspeak embeds its protocol libraries. Release 1.1.0 pins rsReticulum 1.5.0, rsLXMF 1.5.0, and rsLXST 0.4.0, the same releases as the standalone tools, and follows Reticulum 1.6.0, LXMF 1.3.0, and LXST 0.6.0. Building from source explains the exact five-repository source set and toolchains, including builds with voice disabled.
The Tauri frontend calls the Rust backend through app-internal commands and events. Those commands are a contributor interface, not a stable public SDK. Library consumers should start with the component APIs.
The app is published under the Reticulum License. It bundles rsReticulum and rsLXMF, ports of Mark Qvist's reference implementations that carry his copyright under the same license, and voice uses rsLXST under his separate non-commercial LXST license; see Licenses.