gotop is a terminal-based (TUI) system monitor for Linux and macOS. The software is inspired by gtop and vtop, but while these 2 utilities use Node.js, gotop is written in Go.

The command line tool supports mouse clicking and scrolling, comes with vi-keys, and it displays the CPU, memory and network usage history using colored graphs, while also displaying their current values.

gotop also shows the disk usage, temperatures and a top process list, which includes CPU and memory usage.

The process list allows toggling process grouping, and a process can be killed by typing dd. While you can sort the process list by CPU or memory usage, you can’t filter / search for a particular process, change their priority (renice), or show a process tree, like in top or htop utilities.

The memory and CPU graphs can be scaled by using h (scale in) and l (scale out). This information does not appear in the gotop help screen (that can be accessed using ?), so I thought I’d mention it here.

Related: s-tui: CPU Monitoring And Stress Testing Console UI Tool

gotop 2.0.0, released a few days ago, also adds an option to show a battery widget (–battery), and a status bar (–statusbar), that must be explicitly called when running gotop. The status bar doesn’t show on my system when activated though, so there must be some bug or something I missed.

Other gotop features include:

  • built-in color schemes (default, default-dark, solarized and monokai)
  • option to only show CPU, Mem and Process widgets
  • option to set the polling rate for CPU and Memory widgets
  • option to show each CPU or the average CPU usage in the CPU widget
  • option to show temperatures in Fahrenheit degrees (instead of the default Celsius)

It’s worth noting that some gotop widgets are constrained by the terminal size. For example, you may not see all the available CPUs in the CPU usage list on the left unless you increase the terminal height. The same goes for the disks under Disk Usage, and the sensors from the Temperatures list.

Downloading and installing gotop


On the downloads page you’ll find the source code, Linux and macOS binaries.

To install the gotop binary on Linux, start by downloading the binary for your OS architecture. In most cases, that’s 64bit, so download the archive ending in linux_amd64.tgz. Extract the downloaded archive and install it somewhere in your $PATH.

As an example, if the gotop binary is extracted in the current folder, you can install it to /usr/local/bin using:
sudo install gotop /usr/local/bin/

gotop help

Now you can start it by typing gotop in a terminal:
For how to use gotop, press ? which displays some information on working with its TUI (terminal user interface). For more options run gotop –help:
$ gotop –help Usage: gotop [options] Options: -c, –color=NAME Set a colorscheme. -h, –help Show this screen. -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. -f, –fahrenheit Show temperatures in fahrenheit. -s, –statusbar Show a statusbar with the time. -b, –battery Show battery level widget (‘minimal’ turns off). Colorschemes: default default-dark (for white background) solarized monokai

Content retrieved from: