siomon

A comprehensive Linux hardware information and real-time sensor monitoring tool. Single static binary, no runtime dependencies.

Run sio to launch an interactive TUI dashboard that polls all kernel-exported sensors in real time with min/max/avg tracking, configurable alerts, and CSV logging. Use subcommands like sio cpu, sio gpu, or sio storage for one-shot hardware information.

Install

Ubuntu 24.04 / 25.10 (PPA)

sudo apt update
sudo apt install software-properties-common
sudo add-apt-repository ppa:level1techs/siomon
sudo apt update
sudo apt install siomon

Arch Linux (AUR)

# Using an AUR helper (e.g., paru, yay)
paru -S siomon

More installation options are planned. If you'd like to help package siomon for other distributions, see issue #4.

Quick Start

# Interactive TUI sensor monitor (default)
sio

# TUI with custom polling interval (ms)
sio --interval 500

# TUI with CSV logging
sio --log sensors.csv

# Sensor alerts
sio --alert "hwmon/nct6798/temp1 > 80" --alert "hwmon/nct6798/fan1 < 100 @60s"

# Specific sections
sio cpu
sio gpu
sio memory
sio storage
sio network
sio pci
sio pcie           # PCIe link details
sio audio
sio usb
sio battery
sio board

# JSON output (pipe to jq, store, etc.)
sio -f json
sio cpu -f json

# HTML report
sio -f html > report.html

# XML output
sio -f xml > report.xml

# One-shot sensor snapshot
sio sensors
sio sensors -f json

# Full access (SMART, DMI serials, MSR)
sudo sio

Features

Hardware Information (one-shot)

• CPU -- brand, microarchitecture codename, topology (packages/dies/cores/threads), cache hierarchy, feature flags (SSE through AVX-512, AMX), frequency, vulnerability details with mitigation status. Supports x86_64 (via CPUID) and aarch64 (via MIDR_EL1/procfs), including heterogeneous big.LITTLE configurations.
• Memory -- total/available/swap, per-DIMM details (manufacturer, part number, speed, ECC) via custom SMBIOS parser (no dmidecode dependency)
• Motherboard -- board vendor/model, BIOS version/date, UEFI/Secure Boot status, chipset identification, Intel ME firmware version
• GPU -- NVIDIA (via NVML), AMD (via amdgpu sysfs), Intel (via i915/xe sysfs); VRAM, clocks, power limit, PCIe link, display outputs, EDID monitor info
• Storage -- NVMe and SATA devices with model, serial, firmware, capacity; NVMe SMART health data (temperature, wear, hours, errors) via direct ioctl
• Network -- physical adapters with driver, MAC, link speed, IP addresses, NUMA node
• Audio -- HDA/USB audio devices with codec identification
• USB -- device tree with VID:PID, manufacturer, product, speed
• Battery -- charge status, wear level, cycle count, chemistry (laptops)
• PCI -- full bus enumeration with human-readable names from the PCI ID database (25,000+ devices)
• PCIe -- dedicated link analysis: negotiated vs max generation and width per device

Real-time Sensor Monitoring (TUI)

• hwmon -- all kernel-exported sensors: temperatures, fan speeds, voltages, power, current
• CPU -- per-core frequency and utilization
• GPU -- temperature, fan speed, power draw, core/memory clocks, utilization, VRAM usage (NVIDIA via NVML, AMD via sysfs); Tegra integrated GPU frequency and load via devfreq
• RAPL -- CPU package power consumption
• Tegra -- hardware engine clocks and state (APE, DLA, VIC, NVENC, etc.) on NVIDIA Jetson platforms
• Disk -- per-device read/write throughput
• Network -- per-interface RX/TX throughput
• Tracking -- min/max/average for every sensor across the monitoring session
• Collapsible groups -- groups with 32+ sensors auto-collapse; toggle with Enter/Space; collapsed groups show summary min/max/avg
• Alerts -- configurable threshold alerts (--alert "hwmon/nct6798/temp1 > 80 @30s")
• CSV logging -- record sensor data to file while monitoring (--log sensors.csv)
• Board-specific labels -- built-in label overrides for popular boards; user overrides via config file

Output Formats

• Pretty-printed text summary (default for subcommands)
• JSON (-f json)
• XML (-f xml)
• HTML report (-f html) -- self-contained dark-themed report with color-coded vulnerability status
• Per-section views (sio cpu, sio gpu, sio storage, sio pcie, etc.)
• Sensor snapshot (sio sensors)

Configuration

• Config file at ~/.config/siomon/config.toml for persistent preferences
• Sensor label overrides (built-in board mappings + user custom labels)

TUI Keybindings

In filter mode (after pressing /):

Runtime Dependencies

sio has zero mandatory runtime dependencies. Everything is read from kernel interfaces.

Optional Runtime

Privilege Model

sio runs without root and gracefully degrades:

Fields requiring elevation show [requires root] or are omitted.

Building

Prerequisites

• Rust 1.85+ (edition 2024)
• Linux (kernel 4.x+ for full sysfs support; 5.x+ recommended)
• Standard build tools (gcc or cc for libc linking)

Build

cargo build --release

The binary is at ./target/release/sio (~5.3 MB with all features, statically linked PCI ID database).

Cross-compilation

# For a different Linux target
rustup target add aarch64-unknown-linux-gnu
cargo build --release --target aarch64-unknown-linux-gnu

Contributing

See CONTRIBUTING.md for project-specific details and how to contribute.

Packaging

Distribution packages are built and published automatically when a version tag is pushed. See PACKAGING.md for setup and configuration.

• AUR: Workflow queries the AUR API and auto-increments pkgrel when re-publishing the same version. See packaging/aur/.
• PPA: Workflow queries the Launchpad API and auto-increments the packaging revision to avoid upload conflicts. See packaging/launchpad/.

License

MIT