Skip to content
A terminal based graphical activity monitor inspired by gtop and vtop
Branch: master
Clone or download
Latest commit ade4f2a Mar 12, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Revert back to using XDG on macOS Feb 22, 2019
assets Adds battery support Dec 27, 2018
build Readd Makefile Feb 7, 2019
ci Refactor travis files Feb 8, 2019
colorschemes Add vice colorscheme based on vim-vice Feb 21, 2019
scripts refactor: scripts/ Feb 7, 2019
src Minor refactor Mar 12, 2019
LICENSE Added LICENSE Feb 19, 2018
Makefile Change -v to -V for version Feb 22, 2019
main.go Refactor utils Mar 8, 2019

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


Working and tested on Linux, FreeBSD and OSX. Windows support is planned.


go get -u

Prebuilt binaries

Note: Doesn't require Go.

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

git clone --depth 1 /tmp/gotop

Then move gotop into your $PATH somewhere.

Arch Linux

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


pkg install gotop


brew tap cjbassi/gotop
brew install gotop



  • Quit: q or <C-c>
  • Process navigation
    • k and <Up>: up
    • j and <Down: down
    • <C-u>: half page up
    • <C-d>: half page down
    • <C-b>: full page up
    • <C-f>: full page down
    • gg and <Home>: jump to top
    • G and <End>: jump to bottom
  • Process actions:
    • <Tab>: toggle process grouping
    • dd: kill selected process or group of processes
  • Process sorting
    • c: CPU
    • m: Mem
    • p: PID
  • CPU and Mem graph scaling:
    • h: scale in
    • l: scale out
  • ?: toggles keybind help menu


  • click to select process
  • mouse wheel to scroll through processes


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


Built With

Stargazers over time

Stargazers over time

You can’t perform that action at this time.