Go to file
Caleb Bassi 1acf4b0ed8 Added monokai pic 2018-02-25 22:52:05 -08:00
colorschemes Added monokai pic 2018-02-25 22:52:05 -08:00
packages/AUR Updated installers to use version in name 2018-02-19 22:34:49 -08:00
termui Code cleanup and updated README 2018-02-25 22:51:51 -08:00
utils Changed utils to return a float64 2018-02-22 23:58:48 -08:00
vendor Added dep 2018-02-20 19:25:54 -08:00
widgets Code cleanup and updated README 2018-02-25 22:51:51 -08:00
Gopkg.lock Added dep 2018-02-20 19:25:54 -08:00
Gopkg.toml Added dep 2018-02-20 19:25:54 -08:00
LICENSE Added LICENSE 2018-02-19 02:00:26 -08:00
README.md Code cleanup and updated README 2018-02-25 22:51:51 -08:00
build.sh Added build script 2018-02-21 13:08:22 -08:00
demo.gif Added demo.gif 2018-02-21 14:00:40 -08:00
download.sh Code cleanup and updated README 2018-02-25 22:51:51 -08:00
gotop.go Removed gotop specific stuff from termui 2018-02-24 21:35:57 -08:00

README.md

gotop

image

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

Installation

Binaries

Binaries are currently available for 32/64bit Linux and 64bit OSX.

To download the latest binary for your system from GitHub, you can run the download script:

curl https://raw.githubusercontent.com/cjbassi/gotop/master/download.sh | bash

Then move gotop into your $PATH somewhere.

Arch Linux

If you're running Arch Linux, you can install the gotop package from the AUR.

Source

go get github.com/cjbassi/gotop

Usage

Keybinds

  • Quit: q or Ctrl-c
  • 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
  • ?: 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.

TODO

  • Network Usage
    • increase height of sparkline depending on widget size
  • Process List
    • memory total goes above 100%
  • general
    • command line option to set polling interval for CPU and mem
    • command line option to only show processes, CPU, and mem
    • zooming in and out of graphs
    • gopsutil cross-compiling issue on Linux amd64 for darwin i386
  • code cleanup
    • termui buffers should ignore setting characters outside the widget area
      • ignore writes or give an error?
    • termui Blocks should be indexed at 0, and maybe change their X and Y variables too
    • try to get drawille fork merged upstream
    • more documentation
    • Draw borders and label after other stuff
    • Only merge stuff in the buffer's area?