xmtop/README.md
Christopher 'Chief' Najewicz 4bcf8a4c63 Adding instructions to README
2018-10-12 11:49:58 -04:00

3.4 KiB



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

Installation

Working and tested on Linux 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 the gotop-bin package from the AUR.

Homebrew

brew tap cjbassi/gotop
brew install gotop

Source

go get github.com/cjbassi/gotop

Usage

Keybinds

  • Quit: q or <C-c>
  • Process Navigation:
    • <up>/<down> and j/k: up and down
    • <C-d> and <C-u>: up and down half a page
    • <C-f> and <C-b>: up and down a full page
    • gg and G: jump to top and bottom
  • Process Sorting:
    • c: CPU
    • m: Mem
    • p: PID
  • <tab>: toggle process grouping
  • dd: kill the selected process or process group
  • h and l: zoom in and out of CPU and Mem graphs
  • ?: 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 colorschemes.

To make a custom colorscheme, check out the template for instructions and then use default.json as a starter. Then you can 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 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 pkg folder.

Credits

Built With

Stargazers over time

Stargazers over time