tmux-plugins / tmux-online-status

Tmux plugin that displays online status of your computer.

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 curl or wget fails 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:

• battery - battery status in Tmux status-right
• logging - easy logging and screen capturing

License

MIT

tmux-online-status's Issues

Can I add the WiFi signal strength on the status bar?

Hi,

I wonder if it is possible to add the WiFi signal strength on the status bar. I feel it is cooler than the online/offline icon, as the latter is already shown on the macOS menu bar whereas the former isn't.

Documentation Enhancement

It's worth noting you can add colors to text-based symbols in the documentation:

set -g @online_icon "#[fg=colour46]▲"
set -g @offline_icon "#[fg=colour1]▼"

doesnt work on remote machines

Currently, if I open a tmux session on my local machine and ssh to a remote server, the status is not changed with respect to the availability of internet on the remote server.
I guess since the tmux is hosted on my local machine, it doesn't get the information from the remote server currently in focus. Is there a way to achieve this?

git status always show screenshots directory modified

maybe *.png file's issue

bug: doesnot work

added this plugin yesterday, also set status update to 5 . Doesnt do anything

Ping doesn't work in corporate networks, consider curl

Corporate networks usually egress filter ICMP and only allow HTTP(s), so consider using curl to google.com or similar instead on this line (I edited my local one to work around).

tmux-online-status/scripts/online_status_icon.sh

Line 63 in 82f4fbc

ping "$number_pings_flag" 1 "$timeout_flag" "$ping_timeout" "$ping_route" >/dev/null 2>&1

Does not work on FreeBSD

..because ping syntax is incorrectly assumed to be Linux-like, while it is macOS-like, as Darwin is a BSD-based system.

I have submitted PR #10 fixing this, but I see it has not been actioned. Are you interested in PRs or is this an abandoned or perhaps a personal project? I ask, because another new project is awaiting this PR, see samoshkin/tmux-config#2

Many thanks,
Rafal

Can't see 26D4 character

The checkbox and warning sign don't display as emoji for me, but as unicode characters in a "regular" font.
The check mark is displayed (although it is not particularly attractive - it looks like this: http://www.fileformat.info/info/unicode/char/2705/white_heavy_check_mark.svg)
The 26d4 character (the offline symbol) doesn't display at all and instead I see a white box with the letters 26 on the top row and d4 on the bottom row.

I fixed this by changing the offline symbol to U+274C, which displays a nice X that my terminal is able to display.

Is there a trick to getting the character to be displayed as emoji or is it an OSX specific thing?
I am on crunchbang linux, using terminator as my terminal emulator.

Have an Intermittent Symbol

Is it possible to have a glyph sound while it's attempting to check if the online status? Like a question of sorts?