Skip to content

features.md

Latest commit

 

History

History
112 lines (79 loc) · 3.04 KB

features.md

File metadata and controls

112 lines (79 loc) · 3.04 KB
Raw

Features

Detailed breakdown of xtop's monitoring and interface capabilities.

System Monitoring

CPU

  • Usage percentage per core and per thread, displayed as horizontal gauges.
  • Maximum CPU temperature reading when hardware sensors are available.
  • Color-coded bars that visually indicate load levels.

Memory

  • RAM usage gauge showing used, total, and percentage.
  • Swap usage gauge.
  • Historical line chart tracking RAM usage over time.
  • Configurable number of history data points.

Network

  • Real-time upload (TX) and download (RX) tracking per network interface.
  • Total data transferred displayed alongside current transfer speeds.

Storage

  • Disk usage gauges per mount point showing used, available, and total space.
  • Visual percentage bars for each mounted filesystem.

Disk I/O

  • Read and write speed tracking per disk device.
  • Displayed in bytes per second with automatic unit scaling.

Processes

  • Scrolling list of running processes sorted by CPU usage.
  • Live search filtering by process name.
  • Displays process name, CPU usage, and memory usage.

GPU

  • GPU usage gauges (stub implementation, ready for NVIDIA/AMD support).

Battery

  • Battery charge level gauges (stub implementation, ready for laptop support).

Theming

  • 13 ready-to-use color schemes built into the binary.
  • Custom themes defined as JSONC files with a 16-entry hex color palette.
  • Instant theme cycling with t (next) and T (previous).
  • Starter theme files ship in the assets/themes/ directory.

Layouts

  • 7 built-in layout modes: Dashboard, Vertical, Horizontal, CPU Focus, Memory Focus, Network Focus, Process Focus.
  • Custom layouts defined as JSONC files with a recursive split/widget tree.
  • Full-screen mode for any widget toggled with f.
  • Responsive design that adapts to terminal width and height automatically.
  • Minimal fallback layout for very small terminals.

Alert Thresholds

  • Visual warnings when CPU, memory, or disk usage exceeds configurable limits.
  • Color changes to red and warning indicators in widget titles.

Persistence

  • Current theme, layout mode, update interval, history points, and alert thresholds are saved automatically on quit.
  • Configuration is stored at ~/.config/xtop/config.json.

Back to README