A TPM plugin to show uptime in the tmux status bar
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
scripts
LICENSE
README.md
tmux-loadavg.tmux

README.md

tmux-loadavg

Display load average in tmux status bar.

Supports:

  • macOS
  • Linux
  • FreeBSD

Installing

Via TPM (recommended)

The easiest way to install tmux-loadavg is via the Tmux Plugin Manager.

  1. Add plugin to the list of TPM plugins in .tmux.conf:

    set -g @plugin 'jamesoff/tmux-loadavg'
  2. Use prefixI to install tmux-loadavg.

  3. When you want to update tmux-loadavg use prefixU.

Manual Installation

  1. Clone the repository

    $ git clone https://github.com/jamesoff/tmux-loadavg ~/clone/path
  2. Add this line to the bottom of .tmux.conf

    run-shell ~/clone/path/tmux-loadavg.tmux
  3. Reload the tmux environment

    # type this inside tmux
    $ tmux source-file ~/.tmux.conf

Use

Edit your status-left or status-right setting to include one of:

  • #{load_short} - display the 1min load average
  • #{load_full} - display the 1min, 5min and 15min load averages

The values are coloured green, orange or red depending on how they compare to the number of CPUs you have.

For example in .tmux.conf:

# display 1min load average and hostname on right of status bar
set -g status-right " #{load_short} #h"

Reload your configuration for it to take effect: prefix-R with TPM, or

$ tmux source-file ~/.tmux.conf