# Install btop with Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, scoop, winget, zypper Resource monitor. C++ version and continuation of bashtop and bpytop. Version 1.4.7 via Homebrew; verified 2026-07-07. ## Install ```sh sudo av install brew:btop ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install btop ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install btop ``` Evidence: MacPorts ports tree: sysutils/btop/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - apk (92%): ```sh sudo apk add btop ``` Evidence: Alpine Linux edge package indexes: btop from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz - Debian apt (92%): ```sh sudo apt install btop ``` Evidence: Debian stable package indexes: btop from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - dnf (92%): ```sh sudo dnf install btop ``` Evidence: Fedora Rawhide package metadata: btop from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst - Nix (92%): ```sh nix profile install nixpkgs#btop ``` Evidence: nixpkgs package indexes: pkgs/by-name/bt/btop/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S btop ``` Evidence: Arch Linux sync databases: btop from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz - zypper (92%): ```sh sudo zypper install btop ``` Evidence: openSUSE Tumbleweed package metadata: btop from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ### Windows - Scoop (92%): ```sh scoop install main/btop ``` Evidence: Scoop official bucket manifest trees: bucket/btop.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 - winget (92%): ```sh winget install --id aristocratos.btop4win -e ``` Evidence: Windows Package Manager source index: aristocratos.btop4win from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:btop - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.4.7 - **Source summary:** Resource monitor. C++ version and continuation of bashtop and bpytop - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-07-07T13:39:35-04:00 - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - btop (cli) - btop (alias) ## Build dependencies - coreutils - lowdown ## 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.4.7 - Package-manager updated: 2026-07-07 - Local data: ok - Upstream repository: https://github.com/aristocratos/btop - Upstream latest detected: v1.4.7 (current) ## Project history and usage btop is a C++ terminal resource monitor and the continuation of aristocratos' earlier bashtop and bpytop monitors. It presents CPU, memory, disk, network, process, and GPU information in an interactive terminal UI. ### Project history btop began in May 2021 and reached v1.0.0 in September 2021, when the README announced the Linux version as complete. The project explicitly replaced the shell and Python implementations with a C++ version that could gather system information directly. The project quickly expanded beyond Linux: macOS support landed with v1.1.0 in November 2021, FreeBSD support with v1.2.0 in January 2022, OpenBSD and Linux GPU monitoring with v1.3.0 in January 2024, and NetBSD plus Intel GPU support with v1.4.0 in September 2024. ### Adoption history btop became broadly packaged across Unix and Windows-oriented ecosystems. The README includes a Repology packaging badge and the input records packages for Alpine, Homebrew, Debian, Fedora, MacPorts, Nix, Arch, Scoop, Ubuntu, winget, and zypper. Its adoption benefited from continuity with bashtop and bpytop themes and user expectations, while the C++ rewrite made it more suitable as a fast, native package-manager install than the earlier Bash and Python monitors. ### How it is used Users run btop as an interactive terminal monitor to inspect resource graphs, per-process activity, disks, network interfaces, and supported GPU telemetry. It stores settings in btop.conf under the XDG config path or ~/.config/btop and can reuse btop++/bpytop/bashtop-style themes. ### Why package nerds care btop is one of the canonical modern terminal-monitor packages: visually rich, cross-platform, actively packaged, and descended from a trilogy of Bash, Python, and C++ implementations by the same author. For package nerds it is a neat case study in rewriting a beloved script utility into a native package without losing the UI culture around themes and terminal ergonomics. ### Timeline - 2021: Repository starts and v1.0.0 marks the complete Linux release. - 2021: v1.1.0 adds macOS support. - 2022: v1.2.0 adds FreeBSD support. - 2024: v1.3.0 adds Linux GPU monitoring and OpenBSD support. - 2024: v1.4.0 adds Intel GPU support and NetBSD support. ### Related projects - bashtop is the original Bash resource monitor in the lineage. - bpytop is the Python port and continuation of bashtop. - btop4win is a Windows-focused related release linked from the btop README. - Repology is linked by the README to show packaging status across distributions. ### Sources - Local git history from https://github.com/aristocratos/btop shows first commit in 2021 and tags v1.0.0, v1.1.0, v1.2.0, v1.3.0, and v1.4.0. - Official README describes btop as the C++ version and continuation of bashtop and bpytop: https://raw.githubusercontent.com/aristocratos/btop/main/README.md - Official README news records v1.0.0 Linux completion, macOS, FreeBSD, GPU/OpenBSD, and NetBSD/Intel GPU milestones: https://raw.githubusercontent.com/aristocratos/btop/main/README.md - Official bashtop and bpytop READMEs document the Bash and Python predecessor lineage: https://github.com/aristocratos/bashtop and https://github.com/aristocratos/bpytop - Package-manager adoption from 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: $XDG_CONFIG_HOME/btop/btop.conf, ~/.config/btop/btop.conf ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** btop - **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 - btop - 1.3.2-0.1: normalized package name match | Debian stable package indexes: btop from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Modern and colorful command line resource monitor that shows usage and stats | https://github.com/aristocratos/btop - Nix - btop: normalized package name match | nixpkgs package indexes: pkgs/by-name/bt/btop/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Ubuntu apt - btop - 1.3.0-1: normalized package name match | Ubuntu 24.04 LTS package indexes: btop from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Modern and colorful command line resource monitor that shows usage and stats | https://github.com/aristocratos/btop - apk - btop - 1.4.6-r0: normalized package name match | Alpine Linux edge package indexes: btop from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Resource monitor | https://github.com/aristocratos/btop - apk - btop-doc - 1.4.6-r0: normalized package name match | Alpine Linux edge package indexes: btop-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Resource monitor (documentation) | https://github.com/aristocratos/btop - dnf - btop - 1.4.7-1.fc45: normalized package name match | Fedora Rawhide package metadata: btop from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Modern and colorful command line resource monitor that shows usage and stats | https://github.com/aristocratos/btop - pacman - btop - 1.4.7-1: normalized package name match | Arch Linux sync databases: btop from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A monitor of system resources, bpytop ported to C++ | https://github.com/aristocratos/btop - zypper - btop - 1.4.6+git20251226.5b920e3-1.3: normalized package name match | openSUSE Tumbleweed package metadata: btop from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Usage and stats for processor, memory, disks, network and processes | https://github.com/aristocratos/btop - MacPorts - btop: normalized package name match | MacPorts ports tree: sysutils/btop/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 - Scoop - main/btop: normalized package name match | Scoop official bucket manifest trees: bucket/btop.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 - winget - aristocratos.btop4win: normalized package name match | Windows Package Manager source index: aristocratos.btop4win from https://cdn.winget.microsoft.com/cache/source.msix ## 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. - [coreutils](https://www.automicvault.com/pkg/brew/coreutils/) - Build dependency declared by Homebrew. - [lowdown](https://www.automicvault.com/pkg/brew/lowdown/) - Build dependency declared by Homebrew. - [bottom](https://www.automicvault.com/pkg/brew/bottom/) - Shares av.db curated category or tags: cli, monitoring, process-monitor, system. - [bpytop](https://www.automicvault.com/pkg/brew/bpytop/) - Shares av.db curated category or tags: cli, monitoring, resource-monitor, system. - [ctop](https://www.automicvault.com/pkg/brew/ctop/) - Shares av.db curated category or tags: cli, monitoring, system, terminal-ui. - [nvtop](https://www.automicvault.com/pkg/brew/nvtop/) - Shares av.db curated category or tags: cli, monitoring, process-monitor, system. - [sampler](https://www.automicvault.com/pkg/brew/sampler/) - Shares av.db curated category or tags: cli, monitoring, system, terminal-ui. - [zenith](https://www.automicvault.com/pkg/brew/zenith/) - Shares av.db curated category or tags: cli, monitoring, system, terminal-ui. - [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. ## Combined YAML source View the package source record on GitHub. [combined/btop.yml](https://github.com/automic-vault/db/blob/main/combined/btop.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