Another terminal based graphical activity monitor, inspired by [gtop](https://github.com/aksakalli/gtop) and [vtop](https://github.com/MrRio/vtop), this time written in [Go](https://golang.org/)!
## Installation Working and tested on Linux, FreeBSD and OSX. Windows support is planned. ### Source ```bash go get -u github.com/cjbassi/gotop ``` ### Prebuilt binaries **Note**: Doesn't require Go. Clone the repo and then run [scripts/download.sh](./scripts/download.sh) to download the correct binary for your system from the [releases tab](https://github.com/cjbassi/gotop/releases): ```bash 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 ```bash pkg install gotop ``` ### Homebrew ```bash brew tap cjbassi/gotop brew install gotop ``` ### Snap ```bash snap install gotop-cjbassi ``` **Note**: You may need to enable certain permissions for all of the widgets to work: ```bash snap connect gotop-cjbassi:hardware-observe snap connect gotop-cjbassi:mount-observe snap connect gotop-cjbassi:system-observe ``` ## Usage ### Keybinds - Quit: `q` or `` - Process navigation - `k` and ``: up - `j` and ``: half page up - ``: half page down - ``: full page up - ``: full page down - `gg` and ``: jump to top - `G` and ``: jump to bottom - Process actions: - ``: 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](./colorschemes). To make a custom colorscheme, check out the [template](./colorschemes/template.go) for instructions and then use [default.json](./colorschemes/default.json) as a starter. Then put the file at `~/.config/gotop/.json` and load it with `gotop -c `. 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](./assets/battery.png) `-i`, `--interface=NAME` Select network interface [default: all]. ## Credits - [mdnazmulhasan27771](https://github.com/mdnazmulhasan27771) for the [logo](./assets/logo.png) - [f1337](https://github.com/f1337) for helping port gotop to OSX ## Built With - [gizak/termui](https://github.com/gizak/termui) - [nsf/termbox](https://github.com/nsf/termbox-go) - [exrook/drawille-go](https://github.com/exrook/drawille-go) - [shirou/gopsutil](https://github.com/shirou/gopsutil) - [goreleaser/nfpm](https://github.com/goreleaser/nfpm) - [distatus/battery](https://github.com/distatus/battery) ## Stargazers over time [![Stargazers over time](https://starcharts.herokuapp.com/cjbassi/gotop.svg)](https://starcharts.herokuapp.com/cjbassi/gotop)