Go to file
Caleb Bassi ff62b55133 Fix race condition panic 2018-12-31 18:37:47 -08:00
.github/ISSUE_TEMPLATE Update readme and bug report template with new config paths 2018-12-22 19:15:47 -08:00
assets Update demo.gif 2018-05-21 16:37:20 -07:00
build Update build steps 2018-12-13 02:36:24 -08:00
colorschemes Add custom colorscheme loading. Closes #55 2018-09-18 13:42:49 -07:00
scripts Merge branch 'f1337-macos' 2018-05-23 21:46:53 -07:00
src Fix race condition panic 2018-12-31 18:37:47 -08:00
.gitignore Update gitignore 2018-12-12 18:13:39 -08:00
.gitmodules Add aur package submodule 2018-12-01 19:56:59 -08:00
LICENSE Added LICENSE 2018-02-19 02:00:26 -08:00
Makefile Change 'make default' to 'make all' 2018-10-22 20:26:26 -07:00
README.md Port to termui 2.0 2018-12-31 18:23:45 -08:00
go.mod Port to termui 2.0 2018-12-31 18:23:45 -08:00
go.sum Port to termui 2.0 2018-12-31 18:23:45 -08:00
main.go Port to termui 2.0 2018-12-31 18:23:45 -08:00

README.md



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

Installation

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

Using Git

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-bin, gotop, or gotop-git from the AUR.

FreeBSD

pkg install gotop

Homebrew

brew tap cjbassi/gotop
brew install gotop

Source

Note: Requires Go 1.11+.

go get github.com/cjbassi/gotop

Usage

Keybinds

  • 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

Mouse

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

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 on Linux or ~/Library/Application Support/gotop/{name}.json on OSX 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 Show version.
-p, --percpu Show each CPU in the CPU widget.
-a, --averagecpu Show average CPU in the CPU widget.

Building deb/rpms

To build dep/rpms using nfpm:

make all

This will place the built packages into the dist folder.

Credits

Built With

Stargazers over time

Stargazers over time