Complete BLE Stack
Full Bluetooth Low Energy support via btleplug - scan, connect, read current values, download history, configure settings.
Know Your Air Quality In Seconds
The complete Rust toolkit for Aranet sensors. Scan, read, and analyze CO₂, temperature, humidity, radon, and radiation data with blazing-fast performance.
7Rust Crates
4Device Types
3Platforms
MITLicense
Supported Devices
Section titled “Supported Devices”Aranet4Most PopularCO₂, Temperature, Humidity, Pressure
Aranet2Temperature, Humidity
AranetRn+Radon, Temperature, Pressure, Humidity
RadiationDose Rate (µSv/h), Total Dose (mSv)
Why Aranet Rust?
Section titled “Why Aranet Rust?”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 background service with REST API.
Quick Start
Section titled “Quick Start”# macOS and Linux - Recommendedbrew tap cameronrye/aranetbrew install aranet
# Verify installationaranet --version# macOS and Linuxcurl --proto '=https' --tlsv1.2 -LsSf \ https://github.com/cameronrye/aranet/releases/latest/download/aranet-cli-installer.sh | sh
# Verify installationaranet --version# Windowsirm https://github.com/cameronrye/aranet/releases/latest/download/aranet-cli-installer.ps1 | iex
# Verify installationaranet --version# From crates.io (requires Rust toolchain)cargo install aranet-cli
# Verify installationaranet --version# Build from sourcegit clone https://github.com/cameronrye/aranet.gitcd aranet && cargo build --release
# Binary will be at ./target/release/aranet./target/release/aranet --version# Find nearby Aranet devicesaranet scan
# Output:# Found 2 devices:# Aranet4 1234A AA:BB:CC:DD:EE:FF -45 dBm# Aranet2 5678B 11:22:33:44:55:66 -52 dBm# Read current sensor valuesaranet read AA:BB:CC:DD:EE:FF
# Output:# CO₂: 847 ppm (Green)# Temperature: 22.4°C# Humidity: 45%# Pressure: 1013 hPa# Download measurement historyaranet history AA:BB:CC:DD:EE:FF --output history.csv
# Filter by date rangearanet history AA:BB:CC:DD:EE:FF --since 2026-01-15
# Export as JSONaranet history AA:BB:CC:DD:EE:FF --format json# Setup device aliases for easy accessaranet alias set living-room AA:BB:CC:DD:EE:FFaranet alias set bedroom 11:22:33:44:55:66
# Read from multiple devicesaranet read -d living-room -d bedroom
# Watch all aliased devicesaranet watch --allSee It In Action
Section titled “See It In Action”
Powerful Command Line
Scan for devices, read current values, download history, and export to CSV - all from your terminal. Supports aliases for quick access to frequently-used devices.
Real-Time Terminal Dashboard
Monitor multiple devices simultaneously with sparkline charts, color-coded alerts, and vim-style keyboard navigation. Perfect for headless servers and SSH sessions.
Native Desktop Application
Full-featured GUI with real-time charts, historical data visualization, and system tray integration. Available for macOS, Windows, and Linux.
Architecture
Section titled “Architecture”
Core Libraries
Section titled “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
Section titled “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, Prometheus metrics, MQTT publishing, WebSocket streaming.
aranet-gui
Native desktop application with real-time monitoring, charts, and multi-device support.