gotop

Go to file

Caleb Bassi d734634a5d Merge pull request #143 from mgamsjager/freebsd-proc FreeBSD process support		2019-05-15 16:44:11 -07:00
.github/ISSUE_TEMPLATE	Revert back to using XDG on macOS	2019-02-22 11:52:02 -08:00
assets	Adds battery support	2018-12-26 23:15:44 -06:00
build	Readd Makefile	2019-02-07 14:06:40 -08:00
ci	Refactor travis files	2019-02-07 19:36:56 -08:00
colorschemes	Add vice colorscheme based on vim-vice	2019-02-21 02:51:49 -05:00
scripts	refactor: scripts/download.sh	2019-02-07 03:06:55 -08:00
snap	Implement snap packaging, snaps are universal linux packages	2019-04-25 11:11:26 -07:00
src	Proper json helper	2019-05-14 13:00:04 +02:00
vendor	Upgrade termui to v3	2019-03-07 23:15:41 -08:00
.gitignore	Implement snap packaging, snaps are universal linux packages	2019-04-25 11:11:26 -07:00
.travis.yml	Refactor travis files	2019-02-07 19:36:56 -08:00
CHANGELOG.md	Fix changelog	2019-02-22 12:01:50 -08:00
LICENSE	Added LICENSE	2018-02-19 02:00:26 -08:00
Makefile	Change -v to -V for version	2019-02-22 11:50:16 -08:00
README.md	readme: add snap installation instructions	2019-04-25 18:00:25 -07:00
go.mod	Upgrade termui to v3	2019-03-07 23:15:41 -08:00
go.sum	Upgrade termui to v3	2019-03-07 23:15:41 -08:00
main.go	re-render statusbar on every tick	2019-03-17 15:54:56 +01: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.

Source

go get -u 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

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 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

Credits

mdnazmulhasan27771 for the logo
f1337 for helping port gotop to OSX