Monitor Your Air Quality with Rust

Supported Devices

Aranet4CO₂, Temperature, Humidity, Pressure

Aranet2Temperature, Humidity

AranetRn+Radon, Temperature, Pressure, Humidity

Aranet RadiationDose Rate (µSv/h), Total Dose (mSv)

Why Aranet Rust?

Complete BLE Stack

Full Bluetooth Low Energy support via btleplug - scan, connect, read current values, download history, configure settings.

Multi-Platform

Works on macOS, Windows, and Linux. Native performance with Rust’s zero-cost abstractions.

Real-Time Streaming

Subscribe to live sensor updates with auto-reconnection and configurable backoff strategies.

Comprehensive Tooling

CLI for quick readings, TUI dashboard for monitoring, GUI app for desktop, and WASM for browsers.

Quick Start

Homebrew

# macOS and Linux
brew tap cameronrye/aranet
brew install aranet

Shell

# macOS and Linux
curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/cameronrye/aranet/releases/latest/download/aranet-cli-installer.sh | sh

PowerShell

# Windows
irm https://github.com/cameronrye/aranet/releases/latest/download/aranet-cli-installer.ps1 | iex

Cargo

# From crates.io
cargo install aranet-cli

Source

# Build from source
git clone https://github.com/cameronrye/aranet.git
cd aranet && cargo build --release

Scan

# Find nearby Aranet devices
aranet scan

Read

# Read current sensor values
aranet read <DEVICE_ADDRESS>

# Output:
# CO₂: 847 ppm (Green)
# Temperature: 22.4°C
# Humidity: 45%
# Pressure: 1013 hPa

History

# Download measurement history
aranet history <DEVICE_ADDRESS> --output history.csv

# Filter by date range
aranet history <DEVICE_ADDRESS> --since 2026-01-15

Multi-Device

# Read from multiple devices
aranet read -d living-room -d bedroom

# Setup device aliases
aranet alias set living-room AA:BB:CC:DD:EE:FF

Screenshots

Command-Line Interface

Terminal Dashboard

Desktop Application

Architecture

Core Libraries

aranet-types

Platform-agnostic data types shared across all crates - readings, device info, errors.

aranet-core

BLE communication via btleplug - discovery, readings, history, settings, streaming.

aranet-store

SQLite persistence for offline access - incremental sync, deduplication, queries.

Applications

aranet-cli

Command-line interface with multi-device support, aliases, passive mode, CSV export.

aranet-tui

Terminal dashboard with sparklines, alerts, vim keys, multi-device monitoring.

aranet-service

Background daemon with REST API, scheduled syncing, system service integration.

aranet-gui

Native desktop application with real-time monitoring, charts, and multi-device support.

aranet-wasm

WebAssembly module for browser-based sensor access via Web Bluetooth API.

8Crates

4Device Types

3Platforms

MITLicense

---

Made with ❤️ by Cameron Rye

This project is not affiliated with, endorsed by, or sponsored by Aranet or SAF Tehnika JSC. Aranet is a trademark of SAF Tehnika JSC.