Mirrors/bottom
2
0
Fork 0
mirror of https://github.com/ClementTsang/bottom synced 2024-11-10 14:44:18 +00:00
Code Issues Projects Releases Packages Wiki Activity
bottom/README.md

6.6 KiB
Raw Blame History

bottom

Build Status crates.io link

A graphical top clone, written in Rust. Inspired by both gtop and gotop

Quick demo recording

Features

Features of bottom include:

  • CPU widget to show a visual representation of per-core usage. Average CPU display also exists.

  • Memory widget to show a visual representation of both RAM and SWAP usage.

  • Networks widget to show a log-based visual representation of network usage.

  • Sortable and searchable process widget. Searching supports regex, and you can search by PID and process name.

  • Disks widget to display usage and I/O per second.

  • Temperature widget to monitor detected sensors in your system.

The compatibility of each widget and operating systems are, as of version 0.1.0, as follows:

OS/Widget CPU Memory Disks Temperature Processes Networks
Linux ✓ ✓ ✓ ✓ ✓ ✓
Windows ✓ ✓ ✓ Currently not working ✓ Partially supported (total RX/TX unavailable)
macOS Untested Untested Untested Untested Untested Untested

Installation

Linux

You can install the in-development version by cloning and using cargo build --release. You can get release versions using cargo install bottom, or manually building from the Releases page. Other installation methods based on distros are as follows:

Arch Linux

You can get the release versions from the AUR by installing bottom.

Windows

You can install the in-development version by cloning and using cargo build --release. You can get release versions using cargo install bottom, or manually building from the Releases page. You may need to install a font like FreeMono and use a terminal like cmder for font support to work properly, unfortunately.

macOS

macOS support will hopefully come soonTM.

Usage

Run using btm.

Command line options

  • -h, --help shows the help screen and exits.

  • -a, --avgcpu enables also showing the average CPU usage in addition to per-core CPU usage.

  • -m, --dot-marker uses a dot marker instead of the default braille marker.

  • -c, --celsius displays the temperature type in Celsius. This is the default.

  • -f, --fahrenheit displays the temperature type in Fahrenheit.

  • -k, --kelvin displays the temperature type in Kelvin.

  • -v, --version displays the version number and exits.

  • -d, --debug enables debug logging.

  • -r <RATE>, --rate <RATE> will set the refresh rate in milliseconds. Lowest it can go is 250ms, the highest it can go is 2128 - 1. Defaults to 1000ms, and lower values may take more resources due to more frequent polling of data, and may be less accurate in some circumstances.

  • -l, --left_legend will move external table legends to the left side rather than the right side. Right side is default.

  • -u, --current_usage will make a process' CPU usage be based on the current total CPU usage, rather than assuming 100% CPU usage. Only affects Linux for now.

  • g, --group will group together processes with the same name by default (equivalent to pressing Tab).

Keybindings

General

  • q, Ctrl-c to quit. Note if you are currently in the search widget, q will not work so you can still type.

  • Ctrl-r to reset the screen and reset all collected data.

  • f to freeze the screen from updating with new data. Press f again to unfreeze. Note that monitoring will still continue in the background.

  • Ctrl-Up or Ctrl-k, Ctrl-Down or Ctrl-j, Ctrl-Left or Ctrl-h, Ctrl-Right or Ctrl-l to navigate between widgets.

  • Esc to close a dialog window.

  • ? to get a help screen explaining the controls. Note all controls except Esc to close the dialog will be disabled while this is open.

Scrollable Tables

  • Up or k and Down or j scrolls through the list if the widget is a table (Temperature, Disks, Processes).

  • gg or Home to jump to the first entry of the current table.

  • G (Shift-g) or End to jump to the last entry of the current table.

Processes

  • dd to kill the selected process

  • c to sort by CPU usage. Sorts in descending order by default. Press again to reverse sorting order.

  • m to sort by memory usage. Sorts in descending order by default. Press again to reverse sorting order.

  • p to sort by PID. Sorts in ascending order by default. Press again to reverse sorting order.

  • n to sort by process name. Sorts in ascending order by default. Press again to reverse sorting order.

  • Tab to group together processes with the same name. Disables PID sorting. dd will now kill all processes covered by that name.

  • Ctrl-f or / to open the search widget.

Search Widget

  • Ctrl-p or Ctrl-n to switch between searching for PID and name respectively.

  • Esc or Ctrl-f to close.

Note that q is disabled while in the search widget.

Mouse actions

  • Scrolling with the mouse will scroll through the currently selected list.

Thanks, kudos, and all the like