tmux-mem
Display memory usage in your tmux status bar or in the terminal.
Installation
Install Node, then use npm:
sudo npm install -g tmux-mem
Usage
Usage: tmux-mem
Options:
--ascii Display ASCII percentage bar ([====== ] instead of [▆])
--width <int> The width of the ASCII bar, default: 10.
--format <str> Use a custom formatting string.
--no-color Disable colors.
--no-tty Show the raw tmux string.
--help Show help.
--version Show version.
Custom formatting:
The default formatting string is
':currentBytes / :totalBytes [#[fg=:color]:spark#[fg=default]] :percent'.
You can use these tokens in the custom formatting string:
- `:bar`: the ASCII progress bar
- `:spark`: the utf-8 spark line graphic
- `:current`: the number of bytes (raw)
- `:currentBytes`: the number of bytes (with b/kb/mb/gb/tb postfix)
- `:total`: the number of bytes (raw)
- `:totalBytes`: the number of bytes (with b/kb/mb/gb/tb postfix)
- `:percent`: the percentage of memory used
- `:color`: the current bar color (adaptive, based on the percentage)
Colors in the format string:
tmux uses a custom format for specifying colors, which is different from the set of codes used in the terminal. For compatibility, tmux-mem also uses the same format: #[attributes]
where attributes are a comma-separated list of 'fg=color' and 'bg=color', for example:
#[fg=yellow,bold]Yellow bold#[default] Gray
Attributes may a comma-delimited list of one or more of: bright (or bold), dim, underscore, blink, reverse, hidden, or italics.
Color may be one of: black, red, green, yellow, blue, magenta,
cyan, white, default, colour0 to colour255. Newer tmux versions also support RGB strings such as #ffffff. See `man tmux` for more info.
tmux-mem also converts these strings to the appropriate TTY color codes for the terminal.
Integrating with tmux
Make sure you have enabled utf-8 in the status line, either via set -g status-utf8 on
in ~/.tmux.conf
or by running tmux with the -u
flag: tmux -u
.
Add the following line to your ~/.tmux.conf file:
set -g status-right "#(/usr/local/bin/tmux-mem) %H:%M %d-%b-%y"
reload the tmux config by running tmux source-file ~/.tmux.conf.