glances

A modern, feature-rich TUI system monitor written in Rust. Inspired by glances with GPU support, Docker integration, and a built-in API tester.

Install

# Full installation (GPU + Docker support)
cargo install glances

# Minimal installation (no GPU/Docker dependencies)
cargo install glances --no-default-features --features minimal

# GPU support only
cargo install glances --no-default-features --features gpu

# Docker support only
cargo install glances --no-default-features --features docker

Feature Flags

System Dependencies

For GPU monitoring on Linux, ensure NVIDIA drivers are installed:

# The NVML library is required
ls /usr/lib/x86_64-linux-gnu/libnvidia-ml.so.1

For building from source:

# Ubuntu/Debian
sudo apt install pkg-config libssl-dev

# Fedora
sudo dnf install pkg-config openssl-devel

# macOS (for Metal support, no extra deps needed)

Features

System Monitoring

• CPU — global usage, per-core bars, user/sys/idle breakdown, load averages (1m/5m/15m)
• Memory — RAM, swap with total/used/free, gradient bars
• Disk — df-h style display: filesystem, size, used, avail, use%, mounted on
• Network — all interfaces (including lo, utun, awdl), rx/tx rates
• Battery — charge level and state in header
• Sensors — temperature readings with color-coded thresholds
• Processes — sortable by CPU, memory, disk I/O, with kill support

GPU Monitoring

NVIDIA GPUs (Linux/Windows via NVML)

• Multi-GPU utilization, temperature, fan, power, clocks, P-states
• VRAM usage, encoder/decoder, PCIe throughput
• Per-process GPU memory tracking

Apple Silicon GPUs (macOS via Metal)

• GPU memory usage and allocation
• Metal API version detection

Docker Integration

• Container list with CPU%, MEM/MAX, ports, uptime
• Block I/O and network I/O per container
• Container logs viewer — press l on Docker tab
• Built-in HTTP API tester — press Enter on a container to open a Postman-like overlay (GET/POST/PUT/DELETE with headers, JSON body, response viewer)

Alert System

• Auto-detects high CPU (>85%), memory (>75%), load (>1.0/core)
• Shows ongoing/resolved alerts with timestamps

Modern TUI

• Rounded borders, RGB color gradients, smooth braille sparkline graphs
• Tab-based views with number keys
• Mouse support (click to select, scroll to navigate)
• Vim-style keybindings (j/k, PgUp/PgDn)

Usage

# Run with defaults
glances

# Custom refresh rate (ms)
glances -r 500

# Disable GPU/Docker monitoring at runtime
glances --no-gpu --no-docker

# Start with per-core CPU bars
glances --per-core

# Start in compact mode
glances -c

# Show all processes including idle
glances -a

Views

Keyboard Shortcuts

Docker View

Architecture

src/
├── main.rs              — event loop, terminal setup
├── app.rs               — app state, input handling, alerts
├── cli.rs               — clap argument parser
├── types.rs             — data structures
├── utils.rs             — formatting helpers
├── metrics/
│   ├── system.rs        — CPU/mem/disk/net/battery/process collection
│   ├── gpu.rs           — NVML + Metal GPU backends
│   └── docker.rs        — bollard Docker stats
└── ui/
    ├── layout.rs        — main layout coordinator
    ├── tabs.rs          — tab bar
    ├── header.rs        — top bar with hostname, uptime, battery
    ├── footer.rs        — keybinding hints
    ├── system.rs        — CPU/MEM/SWAP/LOAD inline bars, df-h disk view
    ├── gpu.rs           — GPU cards
    ├── graphs.rs        — braille sparkline charts
    ├── processes.rs     — process tables
    ├── docker.rs        — container table
    ├── temps.rs         — sensor panel
    ├── alerts.rs        — alert events panel
    ├── http_dialog.rs   — Postman-like API tester overlay
    ├── logs_dialog.rs   — container logs viewer overlay
    └── dialogs.rs       — help, kill confirm, status

Requirements

• Rust 1.70+
• Linux/Windows: NVIDIA drivers for GPU monitoring (optional)
• macOS: Metal-compatible GPU (Apple Silicon or AMD)
• Docker (optional, for container monitoring)

License

MIT — see LICENSE for details.

Acknowledgments

• Originally forked from nvglances
• Inspired by glances
• Built with ratatui, sysinfo, bollard