https://github.com/ilya-manin/tmux-network-bandwidth

📊 Network bandwidth plugin for tmux
https://github.com/ilya-manin/tmux-network-bandwidth

bandwidth-monitor network-monitoring tmux

Last synced: about 2 months ago
JSON representation

📊 Network bandwidth plugin for tmux

• Host: GitHub
• URL: https://github.com/ilya-manin/tmux-network-bandwidth
• Owner: ilya-manin
• License: mit
• Created: 2019-10-17T15:07:31.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2021-02-14T09:22:01.000Z (over 3 years ago)
• Last Synced: 2024-09-24T04:09:24.303Z (about 2 months ago)
• Topics: bandwidth-monitor, network-monitoring, tmux
• Language: Shell
• Homepage:
• Size: 71.3 KB
• Stars: 77
• Watchers: 2
• Forks: 13
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Network bandwidth plugin for tmux

[![GitHub](https://img.shields.io/github/license/xamut/tmux-network-bandwidth)](https://opensource.org/licenses/MIT)

Shows the network bandwidth in the status line.

![tmux-network-bandwidth](./assets/tmux-preview.png)

## Installation

### Requirements

* awk (GNU awk)

* netstat

* numfmt

macOS: `brew install gawk coreutils`

Linux: `apt-get install gawk net-tools coreutils`

### With Tmux Plugin Manager

Add the plugin in `.tmux.conf`:

```

set -g @plugin 'xamut/tmux-network-bandwidth'

```

Press `prefix + I` to fetch the plugin and source it. Done.

### Manual

Clone the repo somewhere. Add `run-shell` in `.tmux.conf`:

```

run-shell PATH_TO_REPO/tmux-network-bandwidth.tmux

```

NOTE: this line should be placed after `set-option -g status-right ...`.

Press `prefix + :` and type `source-file ~/.tmux.conf`. Done.

## Usage

Add `#{network_bandwidth}` somewhere in the right status line:

```

set-option -g status-right "#{network_bandwidth}"

```

then you will see the bandwidth in the status line: `↓3.5MiB/s • ↑134KiB/s`

## Customization

The plugin could be customized with:

* `set-option -g @tmux-network-bandwidth-padding 12` - Set up the fixed padding for the output.

## Other plugins

* [tmux-spotify](https://github.com/xamut/tmux-spotify)

* [tmux-weather](https://github.com/xamut/tmux-weather)

## License

tmux-network-bandwidth plugin is released under the [MIT License](https://opensource.org/licenses/MIT).