tmux-mem-cpu-load
tmux
CPU, RAM, and load monitor for use withDescription
A simple, lightweight program provided for system monitoring in the status line of tmux.
The memory monitor displays the used and available memory.
The CPU usage monitor outputs a percent CPU usage over all processors. It also displays a textual bar graph of the current percent usage.
The system load average is also displayed.
Example output:
2885/7987MB [||||| ] 51.2% 2.11 2.35 2.44 ^ ^ ^ ^ ^ ^ ^ | | | | | | | 1 2 3 4 5 6 7
- Currently used memory.
- Available memory.
- CPU usage bar graph.
- CPU usage percentage.
- Load average for the past minute.
- Load average for the past 5 minutes.
- Load average for the past 15 minutes.
For terminals with 256 color support, graded colors can be displayed by passing the --colors flag.
Installation
Dependencies
Currently, Linux, Mac OSX, FreeBSD, OpenBSD, and NetBSD are supported.
Building
- >= CMake -3.5
- C++ compiler with C++11 support (e.g. gcc/g++ >= 4.6)
Download
There are links to the source code at the project homepage.
Build
cd <source dir> cmake . make
Install
Recomended to install this as a binary and reference in tmux config below. Current upstream fork will try and build / install on every load of your tmux which causes the binary to not load on first try.
su - make install logout
Install with Package Managers
- Gentoo:
emerge tmux-mem-cpu-load
- Homebrew:
brew install tmux-mem-cpu-load
Antigen
Build and Install UsingInclude the bundle in your .zshrc
antigen bundle thewtex/tmux-mem-cpu-load
tmux
ConfiguringEdit $HOME/.tmux.conf
to display the program's output in status-left or
status-right. For example:
set -g status-interval 2 set -g status-left "#S #[fg=green,bg=black]#(tmux-mem-cpu-load --colors --interval 2)#[default]" set -g status-left-length 60
If you installed using tpm, you must specify the full path to the
tmux-mem-cpu-load
script, like below:
set -g status-right "#[fg=green]#($TMUX_PLUGIN_MANAGER_PATH/tmux-mem-cpu-load/tmux-mem-cpu-load --colors --powerline-right --interval 2)#[default]"
Note that the interval argument to tmux-mem-cpu-load should be the same number of seconds that status-interval is set at.
Another optional argument is the number of bars in the bar graph, which defaults to 10. This can, for instance, be set to the number of cores in a multi-core system.
The colors option will add graded colors for each of the measures.
The full usage:
Usage: tmux-mem-cpu-load [OPTIONS] Available options: -h, --help Prints this help message -c, --colors Use tmux colors in output -p, --powerline-left Use powerline left symbols throughout the output, enables --colors -q, --powerline-right Use powerline right symbols throughout the output, enables --colors -i <value>, --interval <value> Set tmux status refresh interval in seconds. Default: 1 second -g <value>, --graph-lines <value> Set how many lines should be drawn in a graph. Default: 10 -m <value>, --mem-mode <value> Set memory display mode. 0: Default, 1: Free memory, 2: Usage percent. -t <value>, --cpu-mode <value> Set cpu % display mode. 0: Default max 100%, 1: Max 100% * number of threads. -a <value>, --averages-count <value> Set how many load-averages should be drawn. Default: 3
Authors
Matt McCormick (thewtex) <matt@mmmccormick.com>
Contributions from:
- cousine <iam@cousine.me>
- Jasper Lievisse Adriaanse <jasper@humppa.nl>
- Justin Crawford <justinc@pci-online.net>
- krieiter <krieiter@gmail.com>
- Mark Palmeri <mlp6@duke.edu>
- Pawel 'l0ner' Soltys <pwslts@gmail.com>
- Travil Heller <trav.heller@gmail.com>
- Tony Narlock <tony@git-pull.com>
- Compilenix <Compilenix@compilenix.org>
- jodavies <jodavies1010@gmail.com>
- @nhdaly (Nathan Daly) <nhdaly@gmail.com>
- bensuperpc <bensuperpc@gmail.com>