tmux/tmux-plugins.tmux-cpu
1
0
Fork 0
mirror of https://github.com/tmux-plugins/tmux-cpu.git synced 2026-09-10 07:16:16 -04:00
Code Issues Actions Packages Projects Releases Wiki Activity
CPU and GPU info for Tmux.
8 commits 1 branch 0 tags 270 KiB
Shell 100%
Go to file
Larry Glenn a8fcdae801 Grab CPU stats from iostat on a mac 
OSX doesn't have procfs, so grabbing cpu usage from /proc/stat won't
work.

Rather, if is_osx() returns true, get stats from the output of the
iostat utility.

Note that the first line of data that iostat prints is always averaged
over system uptime. You need to tell it to print two lines, averaging
over one second, and use the data in the second line.
2014-12-08 22:54:41 -05:00
scripts Grab CPU stats from iostat on a mac 2014-12-08 22:54:41 -05:00
CHANGELOG.md First commit 2014-11-22 18:25:24 +01:00
cpu.tmux First commit 2014-11-22 18:25:24 +01:00
LICENSE Initial commit 2014-11-22 17:36:20 +01:00
README.md Limit decimal to 1 2014-12-07 17:58:54 +01:00

README.md

Tmux cpu status

Enables displaying cpu percentage and status icon in Tmux status-right.

CPU:
CPU: ❏ 8.7%

This is done by introducing 2 new format strings that can be added to status-right option:

  • #{cpu_icon} - will display a cpu status icon
  • #{cpu_percentage} - will show cpu percentage

Usage

Add #{cpu_icon} or #{cpu_percentage} format strings to existing status-right Tmux option. Example:

# in .tmux.conf
set -g status-right "CPU: #{cpu_icon} #{cpu_percentage} | %a %h-%d %H:%M "

Installation with Tmux Plugin Manager (recommended)

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

set -g @tpm_plugins "             \
  tmux-plugins/tpm                \
  tmux-plugins/tmux-cpu           \
"

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/tmux-plugins/tmux-cpu ~/clone/path

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

run-shell ~/clone/path/cpu.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.

Changing icons

By default, these icons are displayed:

  • cpu: "❏"

You can change these defaults by adding the following to .tmux.conf (the following lines are not in the code block so that emojis can be seen):

  • set-option -g @cpu_icon "😎"

Don't forget to reload TMUX environment ($ tmux source-file ~/.tmux.conf) after you do this.

Limitations

  • CPU change most likely won't be instant.
    It will take some time (15 - 60 seconds) for the value to change. This depends on the status-interval TMUX option.

Other plugins

You might also find these useful:

  • battery - Plug and play battery percentage and icon indicator for Tmux.
  • online status - online status indicator in Tmux status-right. Useful when on flaky connection to see if you're online.

License

MIT