832fab9169 | ||
---|---|---|
.github/ISSUE_TEMPLATE | ||
assets | ||
build | ||
colorschemes | ||
scripts | ||
src | ||
.gitignore | ||
.gitmodules | ||
LICENSE | ||
Makefile | ||
README.md | ||
go.mod | ||
go.sum | ||
main.go |
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
, gotop-bin
, 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>
: upj
and<Down
: down<C-u>
: half page up<C-d>
: half page down<C-b>
: full page up<C-f>
: full page downgg
and<Home>
: jump to topG
and<End>
: jump to bottom
- Process actions:
<Tab>
: toggle process groupingdd
: kill selected process or group of processes
- Process sorting
c
: CPUm
: Memp
: PID
- CPU and Mem graph scaling:
h
: scale inl
: 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
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). widget preview
Building deb/rpms
To build dep/rpms using nfpm:
make all
This will place the built packages into the dist
folder.
Credits
- mdnazmulhasan27771 for the logo
- f1337 for helping port gotop to OSX