explaingit

aristocratos/btop

Analysis updated 2026-06-20

32,038C++Audience · ops devopsComplexity · 2/5LicenseSetup · easy

TLDR

A real-time terminal dashboard showing CPU, memory, network, disk, and process activity for your computer or server. Runs on Linux, macOS, and BSDs.

Mindmap

mindmap
  root((btop))
    What it does
      CPU usage per core
      Memory and swap
      Network traffic
      Process list
    Platforms
      Linux
      macOS
      FreeBSD
    Tech stack
      C++23
      Terminal rendering
    Use cases
      Server monitoring
      Performance debugging
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Monitor a remote server over SSH to see live CPU, memory, and network usage at a glance.

USE CASE 2

Debug performance bottlenecks on a local machine by watching which processes consume the most resources.

USE CASE 3

Track GPU usage on Linux for Nvidia, AMD, or Intel graphics cards alongside system metrics.

USE CASE 4

Replace default OS task managers with a richer, keyboard-driven terminal interface.

What is it built with?

C++C++23

How does it compare?

aristocratos/btopmicrosoft/wsltelegramdesktop/tdesktop
Stars32,03832,15931,685
LanguageC++C++C++
Setup difficultyeasyeasyhard
Complexity2/52/55/5
Audienceops devopsdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Available via most package managers (apt, brew, etc.), no configuration required to start.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

btop is a terminal-based system resource monitor, a program you run in the command line that shows you in real time what your computer is doing: how much CPU is being used, how much memory is consumed, what network traffic is flowing, which processes are running and consuming resources, and optionally how your GPU is performing. The problem it solves is that while every operating system has basic task managers, btop provides a highly visual, information-dense, and attractive overview of system health directly in the terminal, which is especially useful for server management or for developers who spend most of their time in command-line environments. btop runs on Linux, macOS, FreeBSD, NetBSD, and OpenBSD. Its interface uses colored graphs, progress bars, and charts rendered in the terminal using text characters, giving it a polished look without requiring a graphical desktop. The layout is divided into sections for CPU usage (with per-core breakdown), memory and swap usage, disk I/O, network activity, and a process list. GPU monitoring is supported on Linux for Nvidia, AMD, and Intel GPUs. Themes are available to customize the color scheme. Key interactions are done via keyboard shortcuts, and the program is highly configurable through both an in-app menu and a configuration file. It is a successor to earlier tools like bpytop (Python) and bashtop (Bash), rewritten in C++ for significantly better performance. You would use btop when administering a server remotely over SSH and wanting a quick, comprehensive view of system health, or when debugging performance issues on a local machine. Installation is available through most package managers on Linux and macOS (via Homebrew), or by compiling from source. The project is written in C++ using the C++23 standard.

Copy-paste prompts

Prompt 1
I have btop installed on my Linux server. How do I configure it to show GPU stats for my Nvidia card and set a dark color theme?
Prompt 2
Show me the btop keyboard shortcuts for filtering the process list, killing a process, and switching between CPU graph styles.
Prompt 3
I want to run btop over SSH on a headless server. What terminal emulators or SSH client settings do I need for the colored graphs to render correctly?
Prompt 4
How do I create a custom btop theme? Walk me through editing the theme file and applying it.

Frequently asked questions

What is btop?

A real-time terminal dashboard showing CPU, memory, network, disk, and process activity for your computer or server. Runs on Linux, macOS, and BSDs.

What language is btop written in?

Mainly C++. The stack also includes C++, C++23.

What license does btop use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is btop to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is btop for?

Mainly ops devops.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub aristocratos on gitmyhub

Verify against the repo before relying on details.