tmux-ping

KO | EN

gitlite — search

#javascript #react #typescript #deep-learning #linux #docker #java #cli #kubernetes #vue #awesome-list #security #pytorch #open-source

(★ 20)

Tmux ping status plugin

tmux-ping Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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](https://github.com/tmux-plugins/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](https://raw.githubusercontent.com/ayzenquwe/tmux-ping/master/screenshots/example_1.png)

Latency < 400:

![example](https://raw.githubusercontent.com/ayzenquwe/tmux-ping/master/screenshots/example_2.png)

Latency < 1000:

![example](https://raw.githubusercontent.com/ayzenquwe/tmux-ping/master/screenshots/example_3.png)

Latency > 1000:

![example](https://raw.githubusercontent.com/ayzenquwe/tmux-ping/master/screenshots/example_4.png)

#### 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](https://github.com/tmux-plugins/tpm) (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](LICENSE.md)

tmux-ping

tmux-ping Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

tmux-ping

tmux-ping Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README