Tmux plugin that enables displaying online status for your workstation.
Introduces a new #{online_status}
format.
This plugin is useful if:
- you spend most of your time in Tmux and don't want to "switch" away from the terminal to check whether you're connected.
- you have a flaky internet connection and you don't want to be surprised
when a simple
curl
orwget
fails because the connection just broke.
Add #{online_status}
format string to your existing status-right
tmux
option.
Here's the example:
# in .tmux.conf
set -g status-right "Online: #{online_status} | %a %h-%d %H:%M "
The above will result in this:
or this
On linux the emoji is not displayed, instead it will look like this:
or this
The icon will of course change as you connect/disconnect from the internet.
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-online-status \
"
Hit prefix + I
to fetch the plugin and source it.
#{online_status}
interpolation should now work.
Clone the repo:
$ git clone https://github.com/tmux-plugins/tmux-online-status ~/clone/path
Add this line to the bottom of .tmux.conf
:
run-shell ~/clone/path/online_status.tmux
Reload TMUX environment:
# type this in terminal
$ tmux source-file ~/.tmux.conf
#{online_status}
interpolation should now work.
Online status icon most likely won't be instant. The duration depends on the
status-interval
Tmux option. So, it might take anywhere between 5 and 60
seconds for online status icon to change.
Set status-interval
to a low number to make this faster, example:
# in .tmux.conf
set -g status-interval 5
You might also find these useful:
- battery osx - battery status
for OSX in Tmux
status-right
- logging - easy logging and screen capturing