# bpytop

> Terminal-based system resource monitor showing CPU, memory, disk, network and process usage with interactive interface

Stars: 10.9k · Language: Python · License: Apache-2.0 · Categories: System

- Repository: https://github.com/aristocratos/bpytop
- Page: https://www.trmn.sh/tools/bpytop

## Install

- PyPi: `pip3 install bpytop --upgrade`
- Homebrew: `brew install bpytop`
- APT: `sudo apt install bpytop`

## Overview

bpytop is a terminal user interface system resource monitor written in Python. It displays real-time usage statistics for CPU, memory, disks, network interfaces, and running processes in a single terminal window with an interactive interface.

The tool provides full mouse support with clickable buttons and scroll functionality for the process list. Users can select individual processes to view detailed statistics, filter processes with multiple search terms, and send signals (SIGTERM, SIGKILL, SIGINT) to selected processes. The interface includes auto-scaling graphs for network usage, current disk read/write speeds, and keyboard shortcuts for quick navigation between sorting options.

bpytop supports themes compatible with its predecessor bashtop, requires terminals with 24-bit truecolor support (or 256-color with conversion), and needs Unicode support for box drawing and braille pattern characters used in the graphs. The tool runs on Linux, macOS, and FreeBSD, with macOS requiring superuser privileges to display stats for all processes. It includes a configuration menu accessible through the UI for modifying all settings without editing files directly.

### Installation

```bash
# via PyPi
pip3 install bpytop --upgrade
```

```bash
# via Homebrew
brew install bpytop
```

```bash
# via APT
sudo apt install bpytop
```

![Main UI showing detailed process statistics](https://media.trmn.sh/cached/7c9d05a089f6beefa4c375fb09212a69ac0c841d626da194b766ccaf5ce49310.png)

![Main UI in mini mode](https://media.trmn.sh/cached/6eb1a9f09a0cc915d5771af16c11a7ebe09b3b3406f8ab62c02178550930c278.png)

![Main menu interface](https://media.trmn.sh/cached/91432d6eac83925d46a02ff65ab070eeca28c77cf38515c40e1301284c2fa238.png)

## Alternatives

- [BorgBackup](https://www.trmn.sh/tools/borg.md): Deduplicating backup program with optional compression and authenticated encryption, supporting ssh, sftp, s3, b2 and rclone targets, and mountable archives. (Python, 13.9k stars)
- [auto-cpufreq](https://www.trmn.sh/tools/auto-cpufreq.md): Linux CPU speed and power optimizer that adjusts governor and turbo boost based on battery state, CPU load and temperature. Includes CLI, daemon and GUI. (Python, 7.9k stars)
- [nvitop](https://www.trmn.sh/tools/nvitop.md): Interactive NVIDIA GPU and process monitor in Python with tree view, filtering, signal sending, a CUDA device selector (nvisel), and APIs for custom tools. (Python, 7.2k stars)
- [tuptime](https://www.trmn.sh/tools/tuptime.md): System uptime tracking tool that preserves historical uptime/downtime statistics across reboots with detailed reporting (Python, 318 stars)
- [glances](https://www.trmn.sh/tools/glances.md): Cross-platform system monitoring tool with real-time stats display via terminal, web interface, or API (Python, 33.9k stars)

## Guides

- [Modern Replacements for top](https://www.trmn.sh/replace/top): Replace top with htop, btop, or bottom: process lists, graphs, and tree views compared, plus Glances for stdout and API export.
- [Best Terminal System Monitors](https://www.trmn.sh/best/system-monitors): Compare btop, htop, bottom, glances and zenith: terminal system monitors for CPU, memory, disk, network and processes.

---

Canonical: https://www.trmn.sh/tools/bpytop