# Install bottom with Homebrew, apk, chocolatey, MacPorts, Nix, pacman, zypper, scoop, winget, apt
Yet another cross-platform graphical process/system monitor. Version 0.14.7 via Homebrew; verified 2026-07-27. Also installable with nix: nix profile install nixpkgs#bottom.
## Install
```sh
sudo av install brew:bottom
```
Additional install commands:
### macOS
- Homebrew (100%):
```sh
brew install bottom
```
Evidence: local Homebrew formula metadata
- MacPorts (94%):
```sh
sudo port install bottom
```
Evidence: MacPorts ports tree: sysutils/bottom/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
### Linux
- apk (92%):
```sh
sudo apk add bottom
```
Evidence: Alpine Linux edge package indexes: bottom from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz
- Nix (92%):
```sh
nix profile install nixpkgs#bottom
```
Evidence: nixpkgs package indexes: pkgs/by-name/bo/bottom/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- pacman (92%):
```sh
sudo pacman -S bottom
```
Evidence: Arch Linux sync databases: bottom from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz
- zypper (92%):
```sh
sudo zypper install bottom
```
Evidence: openSUSE Tumbleweed package metadata: bottom from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst
- Debian apt (92%):
```sh
sudo apt install btm
```
Evidence: Debian stable package indexes: btm from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz
### Windows
- Chocolatey (92%):
```sh
choco install bottom
```
Evidence: Chocolatey community package catalog: bottom from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='10.436','istioctl'
- Scoop (92%):
```sh
scoop install main/bottom
```
Evidence: Scoop official bucket manifest trees: bucket/bottom.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1
- winget (92%):
```sh
winget install --id Clement.bottom -e
```
Evidence: Windows Package Manager source index: Clement.bottom from https://cdn.winget.microsoft.com/cache/source.msix
## Package facts
- **Package key:** brew:bottom
- **Package manager:** Homebrew
- **Version:** 0.14.7
- **Source summary:** Yet another cross-platform graphical process/system monitor
- **Homepage:**
- **Repository:**
- **Last updated:** 2026-07-27T17:55:18Z
- **Generated:** 2026-08-03T19:37:03+00:00
## Executables
- btm (alias)
## Install behavior
- Bottle: not available
## Freshness
- Page generated: 2026-08-03
- Package-manager version: 0.14.7
## Project history and usage
bottom, invoked as `btm`, is a Rust terminal system monitor that packages the modern TUI system-dashboard experience for Linux, macOS, and Windows.
### Project history
Clement Tsang created the public bottom repository in August 2019. The README describes it as a customizable cross-platform graphical process/system monitor for the terminal, inspired by gtop, gotop, and htop.
The project ships stable and nightly documentation, release binaries, Cargo installation, and many OS package-manager entries, making it a typical Rust CLI that escaped the Cargo-only ecosystem into native system package managers.
### Adoption history
bottom is packaged across Homebrew, MacPorts, Debian/Ubuntu as `btm`, Arch, Nix, Chocolatey, Scoop, winget, and other ecosystems in the supplied package facts. Its GitHub repository metadata shows substantial community interest for a terminal monitor, with more than ten thousand stars by 2026.
The first GitHub release was 0.1.0-alpha-1 in September 2019; by 2026 the project had a continuing nightly release stream and stable documentation.
### How it is used
Users run `btm` for interactive CPU, memory, network, disk, temperature, battery, and process views. The README emphasizes sorting, searching, tree mode, process termination, widget expansion, themes, and configurable layouts.
Configuration is TOML-based and documented per platform; package users often install it as a friendlier alternative to combinations of `top`, `htop`, `iotop`, and ad hoc shell monitoring.
### Why package nerds care
bottom is part of the Rust rewrite wave in classic Unix terminal tools: a single static-feeling cross-platform binary, polished TUI, Cargo upstream, and broad downstream packaging. It matters less as a new monitoring primitive than as a successful packaging story for a modern terminal UX.
### Timeline
- 2019: Public GitHub repository created.
- 2019: 0.1.0-alpha-1 published as the initial GitHub release.
- 2020s: Packaged by Homebrew, Linux distributions, Nix, Windows package managers, and Cargo.
- 2026: Nightly release stream and stable docs remain active.
### Related projects
- htop is the long-running terminal process monitor that bottom cites as inspiration.
- gtop and gotop are graphical terminal system monitors cited by bottom's README.
- btop is another modern terminal resource monitor often considered by the same users.
### 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
- Linux: ~/.config/bottom/bottom.toml, $XDG_CONFIG_HOME/bottom/bottom.toml
- macOS: ~/Library/Application Support/bottom/bottom.toml, ~/.config/bottom/bottom.toml, $XDG_CONFIG_HOME/bottom/bottom.toml
- Windows: C:\Users\\AppData\Roaming\bottom\bottom.toml
## Other Package-Manager Records
- Nix - bottom: normalized package name match | nixpkgs package indexes: pkgs/by-name/bo/bottom/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - bottom - 0.14.7-r0: normalized package name match | Alpine Linux edge package indexes: bottom from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Graphical process/system monitor with a customizable interface | https://github.com/ClementTsang/bottom
- apk - bottom-bash-completion - 0.14.7-r0: normalized package name match | Alpine Linux edge package indexes: bottom-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Bash completions for bottom | https://github.com/ClementTsang/bottom
- apk - bottom-doc - 0.14.7-r0: normalized package name match | Alpine Linux edge package indexes: bottom-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Graphical process/system monitor with a customizable interface (documentation) | https://github.com/ClementTsang/bottom
- apk - bottom-fish-completion - 0.14.7-r0: normalized package name match | Alpine Linux edge package indexes: bottom-fish-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Fish completions for bottom | https://github.com/ClementTsang/bottom
- apk - bottom-zsh-completion - 0.14.7-r0: normalized package name match | Alpine Linux edge package indexes: bottom-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Zsh completions for bottom | https://github.com/ClementTsang/bottom
- pacman - bottom - 0.14.7-1: normalized package name match | Arch Linux sync databases: bottom from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A graphical process/system monitor | https://github.com/ClementTsang/bottom
- zypper - bottom - 0.14.7-1.1: normalized package name match | openSUSE Tumbleweed package metadata: bottom from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Yet another graphical process/system monitor | https://github.com/ClementTsang/bottom
- MacPorts - bottom: normalized package name match | MacPorts ports tree: sysutils/bottom/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Chocolatey - bottom: normalized package name match | Chocolatey community package catalog: bottom from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='10.436','istioctl'
- Scoop - main/bottom: normalized package name match | Scoop official bucket manifest trees: bucket/bottom.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1
- winget - Clement.bottom: normalized package name match | Windows Package Manager source index: Clement.bottom from https://cdn.winget.microsoft.com/cache/source.msix
- Debian apt - btm - 0.10.2+20250107-5: installed executable or alias match | Debian stable package indexes: btm from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | customizable graphical process/system monitor for the terminal | https://clementtsang.github.io/bottom
- Ubuntu apt - btm - 0.9.6-4: installed executable or alias match | Ubuntu 24.04 LTS package indexes: btm from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | customizable graphical process/system monitor for the terminal | https://clementtsang.github.io/bottom
## Combined YAML source
View the package source record on GitHub. [combined/bottom.yml](https://github.com/mxcl/pkgdb/blob/main/combined/bottom.yml)
## Sources
- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph