Home

Awesome

NO LONGER MAINTAINED. A maintained fork of gotop exists at https://github.com/xxxserxxx/gotop.

<div align="center"> <a href="./assets/logo"> <img src="./assets/logo/logo.png" width="20%" /> </a> <br><br>

Another terminal based graphical activity monitor, inspired by gtop and vtop, this time written in Go!

<img src="./assets/demos/demo.gif" /> <img src="./assets/screenshots/minimal.png" width="96%" /> </div>

Installation

Working and tested on Linux, FreeBSD and macOS. Windows support is planned. OpenBSD works with some caveats.

Source

go get github.com/cjbassi/gotop

Prebuilt binaries

Note: Doesn't require Go.

Clone the repo and then run scripts/download.sh to download the correct binary for your system from the releases tab:

git clone --depth 1 https://github.com/cjbassi/gotop /tmp/gotop
/tmp/gotop/scripts/download.sh

Then move gotop into your $PATH somewhere.

Arch Linux

Install gotop, gotop-bin, or gotop-git from the AUR.

FreeBSD

pkg install gotop

Homebrew

brew tap cjbassi/gotop
brew install gotop

Snap

snap install gotop-cjbassi

Note: You may need to enable certain permissions for all of the widgets to work:

snap connect gotop-cjbassi:hardware-observe
snap connect gotop-cjbassi:mount-observe
snap connect gotop-cjbassi:system-observe

Usage

Keybinds

Mouse

Colorschemes

gotop ships with a few colorschemes which can be set with the -c flag followed by the name of one. You can find all the colorschemes in the colorschemes folder.

To make a custom colorscheme, check out the template for instructions and then use default.json as a starter. Then put the file at ~/.config/gotop/<name>.json and load it with gotop -c <name>. Colorschemes PR's are welcome!

CLI Options

-c, --color=NAME Set a colorscheme.
-m, --minimal Only show CPU, Mem and Process widgets.
-r, --rate=RATE Number of times per second to update CPU and Mem widgets [default: 1].
-V, --version Print version and exit.
-p, --percpu Show each CPU in the CPU widget.
-a, --averagecpu Show average CPU in the CPU widget.
-s, --statusbar Show a statusbar with the time.
-b, --battery Show battery level widget (minimal turns off). preview -i, --interface=NAME Select network interface [default: all].

Built With

Stargazers over time

Stargazers over time