blcktop

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

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/ungtb10d/blcktop

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/ungtb10d/blcktop /tmp/blcktop
/tmp/blcktop/scripts/download.sh

Then move blcktop into your $PATH somewhere.

Arch Linux

Install blcktop, blcktop-bin, or blcktop-git from the AUR.

FreeBSD

pkg install blcktop

Homebrew

brew tap ungtb10d/blcktop
brew install blcktop

Snap

snap install blcktop-ungtb10d

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

snap connect blcktop-ungtb10d:hardware-observe
snap connect blcktop-ungtb10d:mount-observe
snap connect blcktop-ungtb10d:system-observe

Usage

Keybinds

• Quit: q or <C-c>
• Process navigation
  • k and <Up>: up
  • j and <Down: down
  • <C-u>: half page up
  • <C-d>: half page down
  • <C-b>: full page up
  • <C-f>: full page down
  • gg and <Home>: jump to top
  • G and <End>: jump to bottom
• Process actions:
  • <Tab>: 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

blcktop 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/blcktop/<name>.json and load it with blcktop -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 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

• gizak/termui
  • nsf/termbox
• exrook/drawille-go
• shirou/gopsutil
• goreleaser/nfpm
• distatus/battery

Stargazers over time