xmtop/README.md
2018-04-09 11:06:23 -07:00

2.3 KiB

gotop

Another TUI graphical activity monitor, inspired by gtop and vtop, this time written in Go!
Built with gopsutil, drawille-go, and my own fork of termui.

Installation

Go programs compile to a single binary and there are currently prebuilt ones for 32/64bit Linux and 64bit OSX. Either clone the repo and run download.sh to download the correct binary, use the AUR if you're on Arch, or build from source.

Using Git

git clone --depth 1 https://github.com/cjbassi/gotop.git /tmp/gotop
/tmp/gotop/download.sh

Then move gotop into your $PATH somewhere.

Arch Linux

Install the gotop-bin package from the AUR.

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

A different Colorscheme can be set with the -c flag followed its name. You can find them in the colorschemes folder.
Feel free to add a new one. You can use 256 colors, bold, underline, and reverse. You can see the template and get more info here and see the default colorscheme as an example here.

CLI Options

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