kernelREADME.mdrepo: xtop-cli/xtop

Xtop

Rust License Platform ratatui

A cross-platform TUI system monitor written in Rust. Uses ratatui for the terminal interface and sysinfo for real-time system metrics.

XTop logo


Contents


Features

  • CPU usage per core with temperature sensing
  • RAM and Swap monitoring with historical chart
  • Network RX/TX tracking per interface
  • Storage and Disk I/O visualization
  • Process list with live search, CPU/Memory/PID/Name sorting and ▲/▼ direction toggling
  • Battery monitoring (real probes on Linux, macOS and Windows)
  • GPU monitoring (NVIDIA via nvidia-smi on any platform; AMD/Intel via Linux sysfs probes)
  • 12 color themes with custom theme support via JSONC
  • 7 built-in layout modes + 3 Detail preset layouts, with custom layout support via JSONC
  • Full-screen mode for any widget
  • Configurable alert thresholds
  • Persistent configuration

See docs/features.md for a detailed feature breakdown.


Previews

Main preview

View more previews


Quick Install

Linux

curl -fsSL https://raw.githubusercontent.com/xtop-cli/xtop/main/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/xtop-cli/xtop/main/install.ps1 | iex

macOS and other platforms

install.sh targets Linux package managers. On macOS (or any other platform) install with cargo:

cargo install --git https://github.com/xtop-cli/xtop --all-features

or build from source (see below).

Build from Source

git clone https://github.com/xtop-cli/xtop.git
cd xtop
cargo run --release

For detailed installation instructions, see docs/installation.md.


Quick Start

Run xtop after installation. Key controls:

KeyAction
qQuit (saves config)
?Toggle help overlay
t / TNext / previous theme
lNext layout mode
f / FToggle / cycle full-screen
/Search processes

For full usage details, see docs/usage.md.


Documentation


Source: README.mdMirrored from the xtop-cli repositories · MITAll docs →