Companion App

Rivr Companion

Monitor and control your Rivr LoRa mesh network from your phone or desktop. Connect over USB serial or Bluetooth LE — no cloud, no subscriptions.

Chat

Send and receive messages over the LoRa mesh network.

Node View

Live view of neighbour nodes with RSSI, SNR, and link scores.

Network Map

Mesh ring diagram and geographic GPS map. Nodes with a stored position appear as markers with haversine distance.

Diagnostics

Live PKT_METRICS counters with charts, sensor readouts, and @SUPPORTPACK export.

Sensors

Live telemetry — temperature, humidity, and battery voltage from connected sensor nodes.

BLE Support

Wireless connection to BLE-enabled Rivr nodes — no cable needed.

Download

Current release · v0.2.0

Android

Android 8.0+

USB SerialBluetooth LE
rivr_companion_android_v0.2.0.apk
APK60.7 MB
Download for Android

Enable 'Install from unknown sources' in Android settings before installing the APK.

Linux

x86_64 · glibc 2.31+

USB Serial
rivr_companion_linux_v0.2.0.zip
ZIP19.9 MB
Download for Linux

Extract the archive and run the rivr_companion binary. Add your user to the dialout group for USB access.

Bluetooth LE not yet tested on Linux.

Windows

Windows 10 / 11

USB Serial
rivr_companion_windows_v0.2.0.zip
ZIP13.9 MB
Download for Windows

Extract the ZIP and run rivr_companion.exe. No installer required — portable app.

Bluetooth LE not yet tested on Windows.

iOS & macOS — coming soon

iOS and macOS builds are in progress. Check back on this page for updates.

Connecting to a node

  1. 1

    Flash your node

    Flash a Rivr client node using the firmware flasher.

  2. 2

    Open the app and go to Settings → Connect

    Choose USB Serial for a wired connection, or Bluetooth LE for a wireless connection to a BLE-enabled node.

  3. 3

    Select your connection

    The app will negotiate the connection and begin streaming live metrics immediately.

  4. 4

    Explore the mesh

    Use the Chat, Nodes, and Network tabs. For detailed diagnostics, tap Diagnostics → Export Supportpack.