Skip to content

ayzenquwe/tmux-ping

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tmux Ping Status

Tmux plugin that allows displaying an average ping latency in the status line. This plugin is heavily influenced by Tmux online status plugin.

Usage

Add #{ping} format string to your existing status-right or status-left tmux option in the .tmux.conf file.

Example:

set -g status-right "Ping: #{ping} #[fg=white]| %Y-%m-%d %I:%M"

The colors are used based on the latency.

Latency < 100:

example

Latency < 400:

example

Latency < 1000:

example

Latency > 1000:

example

Configuration

Change ping host (default: 8.8.8.8):

set -g @ping_host '8.8.8.8'

Enable colors (default: true):

set -g @ping_colorize true

Installation with Tmux Plugin Manager (recommended)

Add plugin to the list of TPM plugins in .tmux.conf:

set -g @plugin 'ayzenquwe/tmux-ping'

Hit prefix + I to fetch the plugin and source it.

Manual Installation

Clone the repo:

$ git clone https://github.com/ayzenquwe/tmux-ping ~/clone/path

Add this line to the bottom of .tmux.conf:

run-shell ~/clone/path/ping.tmux

Reload TMUX environment:

# type this in terminal
$ tmux source-file ~/.tmux.conf

Implementation Details

The main technical difference from Tmux online status plugin is that the ping command is executed in background, and doesn't interfere with the status line update process. If Tmux updates the status line and a previous ping command is not finished (due to big latencies), then a cached value will be used.

License

MIT

About

Tmux ping status plugin

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages