Repository files navigation

A simple, lightweight program provided for system monitoring in thestatusline oftmux.

The memory monitor displays the used and available memory.

The CPU usage monitor outputs a percent CPU usage over all processors. It alsodisplays 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

1. Currently used memory.
2. Available memory.
3. CPU usage bar graph.
4. CPU usage percentage.
5. Load average for the past minute.
6. Load average for the past 5 minutes.
7. Load average for the past 15 minutes.

Forterminals with 256 color support, graded colors can be displayed bypassing the--colors flag.

Currently, Linux, Mac OSX, FreeBSD, OpenBSD, and NetBSD are supported.

• >=CMake -3.5
• C++ compiler with C++11 support (e.g. gcc/g++ >= 4.6)

There are links to the source code at theproject homepage.

cd <source dir>cmake .make

su -make installlogout

Include the plugin in your.tmux.conf, the same file you'll set theconfiguration in, below.

set -g @plugin 'thewtex/tmux-mem-cpu-load'

• Gentoo:emerge tmux-mem-cpu-load
• Homebrew:brew install tmux-mem-cpu-load

Include the bundle in your.zshrc

antigen bundle thewtex/tmux-mem-cpu-load

Edit$HOME/.tmux.conf to display the program's output instatus-left orstatus-right. For example:

set -g status-interval 2set -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 thetmux-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 theinterval argument to tmux-mem-cpu-load should be the same numberof seconds thatstatus-interval is set at.

Another optional argument is the number of bars in the bar graph, whichdefaults to 10. This can, for instance, be set to the number of cores in amulti-core system.

Thecolors 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

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>