Code Monkey home page Code Monkey logo

tmux-online-status's Introduction

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.

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 "

The above will result in this:
online indicator
or this
offline indicator

On linux the emoji is not displayed, instead it will look like this:
online indicator
or this
offline indicator

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.

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 osx - battery status for OSX in Tmux status-right
  • logging - easy logging and screen capturing

License

MIT

tmux-online-status's People

Contributors

jgeralnik avatar

Watchers

 avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.