# Install gotop with Homebrew, apk, MacPorts, Nix, scoop

Terminal based graphical activity monitor inspired by gtop and vtop. Version 4.2.0 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:gotop
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install gotop
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install gotop
```

  Evidence: MacPorts ports tree: sysutils/gotop/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add gotop
```

  Evidence: Alpine Linux edge package indexes: gotop from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Nix (92%):

```sh
nix profile install nixpkgs#gotop
```

  Evidence: nixpkgs package indexes: pkgs/by-name/go/gotop/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

### Windows

- Scoop (92%):

```sh
scoop install main/gotop
```

  Evidence: Scoop official bucket manifest trees: bucket/gotop.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:gotop
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/gotop>
- **Version:** 4.2.0
- **Source summary:** Terminal based graphical activity monitor inspired by gtop and vtop
- **Homepage:** <https://github.com/xxxserxxx/gotop>
- **Repository:** <https://github.com/xxxserxxx/gotop>
- **Upstream docs:** <https://github.com/xxxserxxx/gotop#readme>
- **License:** BSD-3-Clause
- **Source archive:** <https://github.com/xxxserxxx/gotop/archive/refs/tags/v4.2.0.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- gotop (cli)
- gotop (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_big_sur, arm64_linux, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, big_sur, catalina, monterey, sonoma, ventura

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 4.2.0
- Local data: ok
- Upstream repository: https://github.com/xxxserxxx/gotop
- Upstream latest detected: v4.2.0 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

gotop is a terminal-based graphical activity monitor written in Go. It belongs to the family of richer top-like TUIs that trade plain process tables for charts, widgets, colors, and keyboard-driven inspection.

### Project history

The original cjbassi/gotop repository was created in February 2018 and described itself as inspired by gtop and vtop. The xxxserxxx/gotop repository was created in February 2020 after the original author moved to ytop, a Rust rewrite, and deprecated the Go version.

The maintained fork's README documents that the fork exists to keep the Go project alive while keeping a small focused core and providing extension paths for less universal features. Examples called out by the maintainer include NVIDIA sensor support and aggregating data from remote gotop instances.

### Adoption history

gotop spread through multiple package channels because it is a visible terminal utility rather than a library. The README documents Arch, Gentoo, Nix, Homebrew, Scoop, prebuilt binaries, RPM and DEB packages, and source installation.

### How it is used

Users launch gotop in a terminal to monitor CPU, memory, disks, network, processes, batteries, and sensors through a graphical text interface. The README points to layouts, color schemes, device filtering, configuration, and remote-monitoring documentation for users who want to tune the dashboard.

The fork added or folded in features such as layouts, configuration, remote metrics, translations, NVIDIA support, SMART/NVME temperature work, and packaged release artifacts. Its configuration search paths and layout/color-scheme system make it more customizable than a minimal top clone.

### Why package nerds care

gotop is significant in package-manager culture because it is a classic terminal eye-candy package: easy to demo, easy to install, and tied to a lineage of top, htop, gtop, vtop, ytop, bashtop, and bpytop. Its fork history also shows how package ecosystems preserve useful CLIs after an original upstream changes direction.

### Timeline

- 2018: Original cjbassi/gotop repository created and 1.0.0 release published.
- 2019: cjbassi/ytop repository created as a Rust TUI system monitor.
- 2020: xxxserxxx/gotop fork repository created.
- 2020: v3.1.0 release published from the maintained fork.
- 2020: v4.0.0 and v4.0.1 releases moved the fork through a major version line.
- 2021: v4.1.x releases added work including Apple silicon builds, translations, NVIDIA support, and remote support.
- 2022: v4.2.0 release noted contributor-driven maintenance and required Go 1.16 or later for builds.

### Related projects

- gtop and vtop are the JavaScript terminal monitors that inspired the original project.
- ytop is the original author's Rust rewrite.
- top, htop, bashtop, bpytop, atop, iftop, iotop, nmon, ctop, and related tools occupy the same terminal-monitoring family.

### Sources

- <https://formulae.brew.sh/formula/gotop>
- <https://github.com/cjbassi/gotop>
- <https://github.com/cjbassi/ytop>
- <https://github.com/xxxserxxx/gotop>
- <https://github.com/xxxserxxx/gotop#readme>
- <https://github.com/xxxserxxx/gotop/releases>


## 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: ./gotop.conf, ~/.config/gotop/gotop.conf, /etc/gotop/gotop.conf
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** gotop
- **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 - gotop: normalized package name match | nixpkgs package indexes: pkgs/by-name/go/gotop/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - gotop - 4.2.0-r31: normalized package name match | Alpine Linux edge package indexes: gotop from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Terminal based graphical activity monitor | https://github.com/xxxserxxx/gotop
- MacPorts - gotop: normalized package name match | MacPorts ports tree: sysutils/gotop/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Scoop - main/gotop: normalized package name match | Scoop official bucket manifest trees: bucket/gotop.json from https://api.github.com/repos/ScoopInstaller/Main/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.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [bottom](https://www.automicvault.com/pkg/brew/bottom/) - 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.
- [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.
- [pv](https://www.automicvault.com/pkg/brew/pv/) - Shares av.db curated category or tags: cli, monitoring, system, terminal.
- [viddy](https://www.automicvault.com/pkg/brew/viddy/) - Shares av.db curated category or tags: cli, monitoring, system, terminal.
- [ansiweather](https://www.automicvault.com/pkg/brew/ansiweather/) - Shares av.db curated category or tags: cli, monitoring, system, terminal.
- [asitop](https://www.automicvault.com/pkg/brew/asitop/) - Shares av.db curated category or tags: cli, monitoring, system.
- [zenith](https://www.automicvault.com/pkg/brew/zenith/) - Local package facts share a topical domain. Shared terms: cli, graphical, monitor, monitoring, system.

## Combined YAML source

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