NO LONGER MAINTAINED. For a similar program, check out https://github.com/ClementTsang/bottom.

ytop

Missing features

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

Installation

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

Package managers

AUR

ytop is available in three different AUR packages: ytop, ytop-bin, and ytop-git.

COPR

ytop is also available in COPR:

sudo dnf copr enable atim/ytop -y
sudo dnf install ytop

Homebrew

brew tap cjbassi/ytop
brew install ytop

Prebuilt binaries

Prebuilt binaries are provided in the releases tab.

From source

cargo install 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

• bashtop
• bottom
• glances
• gotop
• gtop
• htop
• vtop
• zenith