nvglances
| Crates.io | nvglances |
| lib.rs | nvglances |
| version | 0.1.3 |
| created_at | 2025-12-05 00:06:45.158321+00 |
| updated_at | 2025-12-05 01:34:17.743777+00 |
| description | A TUI system monitor with support for NVIDIA GPUs (CUDA/NVML) and Apple Silicon GPUs (Metal) |
| homepage | |
| repository | https://github.com/EricLBuehler/nvglances |
| max_upload_size | |
| id | 1967351 |
| size | 140,844 |
Eric Buehler (EricLBuehler)
documentation
README
nvglances
A feature-complete terminal UI that combines the best of glances and nvitop - system and GPU monitoring in one tool.
Supports NVIDIA GPUs (via CUDA/NVML) and Apple Silicon GPUs (via Metal).
Features
System Monitoring
- CPU: Global usage, per-core stats, frequency, load averages
- Memory: RAM and swap usage with visual gauges
- Disk: Mount points, filesystem types, usage statistics
- Network: Interface traffic rates and totals
- Processes: Sortable process table with CPU/memory usage
GPU Monitoring
NVIDIA GPUs (Linux/Windows via NVML)
- Multi-GPU support: Monitor all NVIDIA GPUs simultaneously
- GPU metrics: Utilization, temperature, fan speed, power draw
- Memory: VRAM usage per GPU
- Clocks: SM and memory clock frequencies
- P-States: Performance state display (P0-P15)
- Encoder/Decoder: Video engine utilization
- PCIe throughput: Data transfer rates
- GPU processes: Track processes using GPU resources
Apple Silicon GPUs (macOS via Metal)
- Multi-GPU support: Monitor all Metal-compatible GPUs
- Memory: GPU memory usage and allocation
- Metal API version: Displays Metal 3, Metal 2, etc.
User Interface
- Adaptive layout: Automatically adjusts to terminal size
- Compact mode: Condensed view for smaller terminals
- History graphs: CPU and GPU utilization over time
- Color-coded: Visual indicators for resource usage levels
- Mouse support: Click to select, scroll to navigate
- Process management: Kill processes with confirmation dialog
Installation
From crates.io
cargo install nvglances
From source
# Clone the repository
git clone https://github.com/EricLBuehler/nvglances.git
cd nvglances
# Build release binary
cargo build --release
# Install (optional)
cargo install --path .
Requirements
- Rust 1.70 or later
- Linux/Windows: NVIDIA drivers for GPU monitoring
- macOS: Metal-compatible GPU (Apple Silicon or AMD)
Usage
# Run nvglances
nvglances
# Or run directly from target
./target/release/nvglances
Keyboard Shortcuts
| Key | Action |
|---|---|
? / F1 |
Show help |
q / Esc |
Quit |
Tab |
Switch between CPU and GPU process panels |
j / ↓ |
Move selection down |
k / ↑ |
Move selection up |
PgDn / PgUp |
Move selection by page |
Home / End |
Jump to first/last item |
1-6 |
Sort by column (PID, Name, User, CPU%, MEM%, GPU MEM) |
r |
Reverse sort order |
a |
Toggle show all processes |
g |
Toggle history graphs |
c |
Toggle compact mode |
+ / - |
Adjust refresh rate |
Process Control
| Key | Signal | Description |
|---|---|---|
Del / Ctrl+T |
SIGTERM | Graceful termination |
Ctrl+K |
SIGKILL | Force kill |
Ctrl+I |
SIGINT | Interrupt |
A confirmation dialog appears before killing any process.
Mouse Support
- Click on process tables to select rows
- Scroll to navigate up/down in process lists
Configuration
nvglances currently uses sensible defaults. Configuration file support may be added in future versions.
Contributing
Contributions are welcome! Please feel free to submit issues and pull requests.
Development Setup
# Clone and enter directory
git clone https://github.com/yourusername/nvglances.git
cd nvglances
# Build in debug mode (faster compilation)
cargo build
# Run with debug output
RUST_BACKTRACE=1 cargo run
# Run tests
cargo test
# Check formatting
cargo fmt --check
# Run linter
cargo clippy
Code Style
- Follow standard Rust conventions
- Use
cargo fmtbefore committing - Add comments for complex logic
- Keep functions focused and small
License
MIT License - see LICENSE for details.