danog/ytop
1
0
Fork 0
mirror of https://github.com/danog/ytop.git synced 2024-11-29 20:19:01 +01:00
Code Issues Projects Releases Wiki Activity
193 Commits 9 Branches 12 Tags 811 KiB
Rust 100%
5ef25391e3
Go to file
Jerome Coquisart 5ef25391e3 update README
2020-04-21 22:17:13 +02:00
.github Update issue template 2020-01-25 07:25:16 -08:00
assets Add media from gotop 2020-01-13 08:40:58 -08:00
colorschemes Add media from gotop 2020-01-13 08:40:58 -08:00
package-publisher 0.5.1 2020-02-16 16:45:45 -08:00
src Fixes missing temperature on mac os 2020-04-21 20:36:11 +02:00
.editorconfig Fix yml indentation 2019-07-29 22:18:52 -07:00
.gitignore Initial commit 2019-07-20 17:57:40 -07:00
.rustfmt.toml Convert spaces to tabs 2019-07-26 20:28:16 -07:00
Cargo.lock Fixes missing temperature on mac os 2020-04-21 20:36:11 +02:00
Cargo.toml Fixes missing temperature on mac os 2020-04-21 20:36:11 +02:00
CHANGELOG.md update changelog and readme 2020-04-21 12:06:37 -07:00
LICENSE Initial commit 2019-07-20 17:57:40 -07:00
README.md update README 2020-04-21 22:17:13 +02:00

README.md

ytop

Minimum rustc version Matrix

Another TUI based system monitor, this time in Rust!

Missing features

  • macOS is missing disk io counters and process commandline
  • Process filtering isn't implemented
  • Mouse usage isn't implemented

Installation

Currently works on Linux and macOS with support planned for all major platforms.

Prebuilt binaries

Prebuilt binaries are provided in the releases tab.

Arch Linux

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

Homebrew

brew tap cjbassi/ytop
brew install ytop

Alpine Linux

Available in the testing repository, so you need to be on Alpine Linux Edge.

apk add ytop

From source

cargo install -f --git https://github.com/cjbassi/ytop ytop

Usage

Keybinds

  • Quit: q or <C-c>
  • Pause: <Space>
  • 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 process group
  • Process sorting:
    • p: PID/Count
    • n: Command
    • c: CPU
    • m: Mem
  • Process filtering:
    • /: start editing filter
    • (while editing):
      • <Enter>: accept filter
      • <C-c> and <Escape>: clear filter
  • 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

ytop 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, copy one of the default ones to ~/.config/ytop/<new-name>.json and load it with ytop -c <new-name>. Colorscheme PRs are welcome!

CLI Options

USAGE:
    ytop [FLAGS] [OPTIONS]

FLAGS:
    -a, --average-cpu    Show average CPU in the CPU widget
    -b, --battery        Show Battery widget (overridden by 'minimal' flag)
    -f, --fahrenheit     Show temperatures in fahrenheit
    -h, --help           Prints help information
    -m, --minimal        Only show the CPU, Mem, and Process widgets
    -p, --per-cpu        Show each CPU in the CPU widget
    -s, --statusbar      Show a statusbar with the time
    -V, --version        Prints version information

OPTIONS:
    -c, --colorscheme <colorscheme>    Set a colorscheme [default: default]
    -i, --interface <interface>        The name of the network interface to show in the Net widget. 'all' shows all
                                       interfaces [default: all]
    -I, --interval <interval>          Interval in seconds between updates of the CPU and Mem widgets. Can specify
                                       either a whole number or a fraction with a numerator of 1 [default: 1]

Related projects