# Install bpytop with Homebrew, apt, MacPorts, pacman Linux/OSX/FreeBSD resource monitor. Version 1.0.68 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:bpytop ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install bpytop ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install bpytop ``` Evidence: MacPorts ports tree: sysutils/bpytop/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - Debian apt (92%): ```sh sudo apt install bpytop ``` Evidence: Debian stable package indexes: bpytop from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - pacman (92%): ```sh sudo pacman -S bpytop ``` Evidence: Arch Linux sync databases: bpytop from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz ## Package facts - **Package key:** brew:bpytop - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.0.68 - **Source summary:** Linux/OSX/FreeBSD resource monitor - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - bpytop (cli) - bpytop (alias) ## Dependencies - osx-cpu-temp - python@3.14 ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.0.68 - Local data: ok - Upstream repository: https://github.com/aristocratos/bpytop - Upstream latest detected: v1.0.68 (current) - info: No package-manager update timestamp was available. ## Project history and usage bpytop is a Python terminal resource monitor for Linux, macOS, and FreeBSD. It belongs to the lineage of highly visual TUI system monitors that trade plain tabular process lists for responsive graphs, mouse support, themes, and in-terminal process management. ### Project history The project was created on GitHub in 2020 by aristocratos. Its README describes bpytop as a Python port and continuation of bashtop, carrying over bashtop-compatible themes while expanding the implementation around Python and psutil. In 2021 the same author began a third iteration, btop, written in C++. The bpytop README documents that btop++ was completed for Linux and released as version 1.0.0 on 18 September 2021, making bpytop an important middle step in the bashtop to btop evolution. ### Adoption history The official README lists installation through PyPI, Homebrew, MacPorts, Arch Linux, Snapcraft, and other distribution channels. The input package facts also record packaging in Homebrew, Debian, MacPorts, Arch, and Ubuntu, which reflects broad Unix-like package-manager adoption for a terminal monitor. bpytop became popular partly because it packaged a polished dashboard experience as a single CLI command, a pattern that suited Homebrew and Linux distribution users who wanted richer terminal monitoring without a desktop application. ### How it is used Users run bpytop to inspect CPU, memory, disk, network, and process state from the terminal. The README highlights filtering, process sorting, selected-process details, mouse support, and sending SIGTERM, SIGKILL, or SIGINT from the interface. The project depends on Python 3.7 or newer and psutil. Its terminal UI expects UTF-8, wide character support, and either truecolor or 256-color fallback, which is typical of modern TUI tools that rely on box drawing and braille graph characters. ### Why package nerds care For package-history nerds, bpytop is notable as the transitional Python entry in aristocratos' resource-monitor trilogy: bashtop in Bash, bpytop in Python, and btop in C++. It shows how the same terminal UX moved across implementation languages as performance and portability needs changed. It is also a good example of how TUI tools spread through multiple package ecosystems at once: PyPI for upstream freshness, Homebrew and MacPorts for macOS users, distro packages for Linux users, and Snapcraft for cross-distro installs. ### Timeline - 2020: The bpytop GitHub repository was created. - 2020: The README identifies bpytop as the Python port and continuation of bashtop. - 2021-05: The author announced work on a third iteration in C++ named btop. - 2021-09: The bpytop README announced btop++ 1.0.0 for Linux. ### Related projects - bashtop is the predecessor named by the bpytop README. - btop is the C++ successor documented in the bpytop README news section. - psutil is the Python system-information library listed as bpytop's core runtime dependency. ### Sources - - - source_facts.package-manager ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.config/bpytop/bpytop.cfg ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** bpytop - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Debian apt - bpytop - 1.0.68-2: normalized package name match | Debian stable package indexes: bpytop from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Resource monitor that shows usage and stats | https://github.com/aristocratos/bpytop - Ubuntu apt - bpytop - 1.0.68-2: normalized package name match | Ubuntu 24.04 LTS package indexes: bpytop from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Resource monitor that shows usage and stats | https://github.com/aristocratos/bpytop - pacman - bpytop - 1.0.68-2: normalized package name match | Arch Linux sync databases: bpytop from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Resource monitor that shows usage and stats for processor, memory, disks, network and processes | https://github.com/aristocratos/bpytop - MacPorts - bpytop: normalized package name match | MacPorts ports tree: sysutils/bpytop/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider. - [osx-cpu-temp](https://www.automicvault.com/pkg/brew/osx-cpu-temp/) - Runtime dependency declared by Homebrew. - [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew. - [btop](https://www.automicvault.com/pkg/brew/btop/) - Shares av.db curated category or tags: cli, monitoring, resource-monitor, system. - [gkrellm](https://www.automicvault.com/pkg/brew/gkrellm/) - Shares av.db curated category or tags: cli, monitoring, system, system-monitoring. - [glances](https://www.automicvault.com/pkg/brew/glances/) - Shares av.db curated category or tags: cli, monitoring, system, system-monitoring. - [lcdproc](https://www.automicvault.com/pkg/brew/lcdproc/) - Shares av.db curated category or tags: cli, monitoring, system, system-monitoring. - [ansiweather](https://www.automicvault.com/pkg/brew/ansiweather/) - Shares av.db curated category or tags: cli, monitoring, system. - [asitop](https://www.automicvault.com/pkg/brew/asitop/) - Shares av.db curated category or tags: cli, monitoring, system. - [bottom](https://www.automicvault.com/pkg/brew/bottom/) - Shares av.db curated category or tags: cli, monitoring, system. - [collectd](https://www.automicvault.com/pkg/brew/collectd/) - Shares av.db curated category or tags: cli, monitoring, system. - [tmux-mem-cpu-load](https://www.automicvault.com/pkg/brew/tmux-mem-cpu-load/) - Local package facts share a topical domain. Shared terms: cli, cpu, monitor, monitoring, system. ## Combined YAML source View the package source record on GitHub. [combined/bpytop.yml](https://github.com/automic-vault/db/blob/main/combined/bpytop.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph