kforney/pentest-distro-builder
1
0
Fork 0
mirror of https://github.com/kforney/pentest-distro-builder.git synced 2024-11-01 08:59:11 -06:00
Code Issues Projects Releases Packages Wiki Activity
pentest-distro-builder/filesystem/etc/skel/.tmux/plugins/tmux-cpu/README.md
Kaj Forney a6d12f1ffc Move stuff to /etc/skel 
Former-commit-id: 7bddceacd727c25153cd0ec03cf8b0d4011484d5
Former-commit-id: aaf57e63c1976b3960fee717c68c3b09dc1a94ff
2018-10-18 13:47:28 -06:00

2.3 KiB
Raw Blame History

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 "

Optional requirement (Linux, BSD, OSX)

iostat or sar are the best way to get an accurate cpu percentage

A fallback is included using ps -aux but could be inaccurate.

Installation with Tmux Plugin Manager (recommended)

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

set -g @plugin '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