Skip to content
Tmux plugin that displays online status of your computer.
Branch: master
Clone or download
bruno- Merge pull request #15 from m3phisto/patch-1
Make git treat gif/png images as binary
Latest commit 82f4fbc Nov 30, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
scripts Added support for FreeBSD Dec 9, 2017
.gitattributes Can now set the ping timeout value Jun 17, 2015 First commit Jun 2, 2014 Updated for FreeBSD Dec 9, 2017
online_status.tmux Fix status-right, status-left whitespace issue May 23, 2015

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.


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 "

On OS X the above will look like this when online
online indicator
or this when offline
offline indicator

Online status on Linux
online indicator
offline status
offline indicator

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 ~/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

Other plugins

You might also find these useful:

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



You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.