Tmux online status
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
curlorwgetfails because the connection just broke.
Tested and working on Linux, OSX, FreeBSD, and Cygwin.
Usage
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 "
OS X
On OS X the above will look like this when online
or this when offline
Linux
Online status on Linux
offline status
Configure icons
If the icons don't display well on your machine you can change them in
.tmux.conf:
set -g @online_icon "ok"
set -g @offline_icon "offline!"
Installation with Tmux Plugin Manager (recommended)
Add plugin to the list of TPM plugins in .tmux.conf:
set -g @plugin 'tmux-plugins/tmux-online-status'
Hit prefix + I to fetch the plugin and source it.
#{online_status} interpolation should now work.
Manual Installation
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.
Limitations
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
Other plugins
You might also find these useful: