# Install bottom with Homebrew, apk, chocolatey, MacPorts, Nix, pacman, scoop, winget, zypper, apt

Yet another cross-platform graphical process/system monitor. Version 0.14.3 via Homebrew; verified 2026-07-02.

## 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/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-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='8.6352005','msys2-installer'

- 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
- **Package manager page:** <https://formulae.brew.sh/formula/bottom>
- **Version:** 0.14.3
- **Source summary:** Yet another cross-platform graphical process/system monitor
- **Homepage:** <https://clementtsang.github.io/bottom/>
- **Repository:** <https://github.com/ClementTsang/bottom>
- **Upstream docs:** <https://bottom.pages.dev/stable>
- **License:** MIT
- **Source archive:** <https://github.com/ClementTsang/bottom/archive/refs/tags/0.14.3.tar.gz>
- **Last updated:** 2026-07-02T08:02:28Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- btm (cli)
- btm (alias)

## Build dependencies

- rust

## 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: 0.14.3
- Package-manager updated: 2026-07-02
- Local data: ok
- Upstream repository: https://github.com/ClementTsang/bottom
- Upstream latest detected: 0.14.3 (current)
## 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

- <https://api.github.com/repos/ClementTsang/bottom>
- <https://bottom.pages.dev/stable>
- <https://bottom.pages.dev/stable/configuration/config-file>
- <https://github.com/ClementTsang/bottom>
- 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\<USER>\AppData\Roaming\bottom\bottom.toml
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** bottom
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## 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.12.3-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.12.3-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.12.3-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.12.3-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.12.3-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.12.3-2: 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.12.3-1.3: normalized package name match | openSUSE Tumbleweed package metadata: bottom from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-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='8.6352005','msys2-installer'
- 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


## 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.
- [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [gotop](https://www.automicvault.com/pkg/brew/gotop/) - Shares av.db curated category or tags: cli, monitoring, system, system-monitor, terminal.
- [gtop](https://www.automicvault.com/pkg/brew/gtop/) - Shares av.db curated category or tags: cli, monitoring, system, system-monitor, terminal.
- [ansiweather](https://www.automicvault.com/pkg/brew/ansiweather/) - Shares av.db curated category or tags: cli, monitoring, system, terminal.
- [btop](https://www.automicvault.com/pkg/brew/btop/) - Shares av.db curated category or tags: cli, monitoring, process-monitor, system.
- [devcockpit](https://www.automicvault.com/pkg/brew/devcockpit/) - Shares av.db curated category or tags: cli, monitoring, system, system-monitor.
- [framework-tool-tui](https://www.automicvault.com/pkg/brew/framework-tool-tui/) - Shares av.db curated category or tags: cli, monitoring, rust, system.
- [htop](https://www.automicvault.com/pkg/brew/htop/) - Shares av.db curated category or tags: cli, monitoring, system, terminal.
- [hwatch](https://www.automicvault.com/pkg/brew/hwatch/) - Shares av.db curated category or tags: cli, monitoring, system, terminal.

## Combined YAML source

View the package source record on GitHub. [combined/bottom.yml](https://github.com/automic-vault/db/blob/main/combined/bottom.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
