/tmux-temp

tmux plugin to show CPU temperature

Primary LanguageShell

tmux-temp

Enables displaying CPU temperature in Tmux status-right and status-left. Configurable temperature units.

Requirements

On Linux

Using hardware monitoring chips

Requires lm_sensors package to be installed and configured. info

sudo apt-get install lm-sensors

# After installation type the following in terminal
sudo sensors-detect

# You may also need to run
sudo service kmod start

On Raspberry Pi Raspbian

This plugin uses vcgencmd measure_temp command on RPi Raspbian to get CPU temperature. Should be compatible with other RPi distros with vcgencmd available.

On macOS

This plugin uses lavoiesl/osx-cpu-temp.

$ git clone https://github.com/lavoiesl/osx-cpu-temp /tmp/osx-cpu-temp
$ (cd /tmp/osx-cpu-temp && make && sudo make install)
$ rm -rf /tmp/osx-cpu-temp

Installation

Installation with Tmux Plugin Manager (recommended)

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

set -g @plugin 'kolach/tmux-temp'

Hit prefix + I to fetch the plugin and source it.

If format strings are added to status-right, they should now be visible.

Manual Installation

Clone the repo:

$ git clone https://github.com/kolach/tmux-temp ~/clone/path

Add this line to the bottom of .tmux.conf:

run-shell ~/clone/path/temp.tmux

Reload TMUX environment:

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

If format strings are added to status-right, they should now be visible.

Usage

Add any of the supported format strings (see below) to the existing status-right tmux option. Example:

# in .tmux.conf
set -g status-right 'temp: #{temp_cpu} | %a %h-%d %H:%M '

Supported Options

  • #{temp_units} - Temperature units. Valid options: "C" or "F" (default "C")