gotop

by cjbassi

cjbassi /gotop

A terminal based graphical activity monitor inspired by gtop and vtop

7.0K Stars 283 Forks Last release: over 1 year ago (3.0.0) GNU Affero General Public License v3.0 435 Commits 33 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

NO LONGER MAINTAINED. A maintained fork of gotop exists at https://github.com/xxxserxxx/gotop.



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

Installation

Working and tested on Linux, FreeBSD and macOS. Windows support is planned. OpenBSD works with some caveats.

Source

go get github.com/cjbassi/gotop

Prebuilt binaries

Note: Doesn't require Go.

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

Snap

snap install gotop-cjbassi

Note: You may need to enable certain permissions for all of the widgets to work:

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
      : down
    • : 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.

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/.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
-i
,
--interface=NAME
Select network interface [default: all].

Built With

Stargazers over time

Stargazers over time

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.