Expand description
Command-line interface for Aranet environmental sensors.
This crate provides a comprehensive CLI for interacting with Aranet devices including the Aranet4, Aranet2, AranetRn+ (Radon), and Aranet Radiation sensors.
§Features
- Device scanning: Discover nearby Aranet devices via BLE
- Current readings: Display real-time sensor values with color-coded status
- Historical data: Download and export measurement history
- Device configuration: Adjust measurement interval, Bluetooth range, and Smart Home mode
- Continuous monitoring: Watch mode for ongoing data collection
- Multiple output formats: Text, JSON, and CSV output support
- Configuration file: Persistent settings for default device and preferences
- Shell completions: Generate completions for bash, zsh, fish, and PowerShell
§Commands
| Command | Description |
|---|---|
scan | Scan for nearby Aranet devices |
read | Read current sensor values |
status | Quick one-line status display |
history | Download historical data |
info | Display device information |
set | Configure device settings |
watch | Continuously monitor a device |
config | Manage CLI configuration |
completions | Generate shell completions |
§Output Formats
The CLI supports three output formats:
- Text (default): Human-readable colored output
- JSON: Machine-readable JSON format
- CSV: Comma-separated values for spreadsheets and data analysis
§Configuration
The CLI stores configuration in ~/.config/aranet/config.toml (or platform equivalent).
Configuration options include:
device: Default device addressformat: Default output formatno_color: Disable colored outputfahrenheit: Use Fahrenheit for temperature display
§Environment Variables
ARANET_DEVICE: Default device address (overridden by--deviceflag)NO_COLOR: Disable colored output when set
§Examples
Scan for devices:
aranet scanRead current values from a specific device:
aranet read --device AA:BB:CC:DD:EE:FFDownload history as CSV:
aranet history --device AA:BB:CC:DD:EE:FF --format csv --output data.csvWatch a device continuously:
aranet watch --device AA:BB:CC:DD:EE:FF --interval 60Set measurement interval:
aranet set --device AA:BB:CC:DD:EE:FF interval 5Re-exports§
pub use aranet_core;pub use aranet_types;
Modules§
- tui
- TUI module for Aranet terminal dashboard.