tmux-net-speed
March 17, 2026 ยท View on GitHub
A tmux plugin for displaying network upload and download speed in the status bar.
๐ฅ Installation
Install using TPM
Add this line to your tmux config file, then hit prefix + I:
set -g @plugin 'wfxr/tmux-net-speed'
Install manually
git clone https://github.com/wfxr/tmux-net-speed ~/.tmux/plugins/tmux-net-speed
Then add the following line to your ~/.tmux.conf:
run-shell ~/.tmux/plugins/tmux-net-speed/net-speed.tmux
๐ Usage
Use #{upload_speed} and #{download_speed} in your status-right or status-left options:
set -g status-right '#{upload_speed} #{download_speed}'
This works great with tmux-power:
set -g @tmux_power_show_upload_speed true
set -g @tmux_power_show_download_speed true
โ Configuration
| Option | Default | Description |
|---|---|---|
@net_speed_interfaces | (empty) | Space-separated list of interfaces to monitor. If empty, all non-virtual interfaces are used. |
@upload_speed_format | %7s | printf format string for upload speed |
@download_speed_format | %7s | printf format string for download speed |
Example:
set -g @upload_speed_format '%s'
set -g @download_speed_format '%s'
๐ป Supported Platforms
- Linux
- macOS
- FreeBSD
- NetBSD
- OpenBSD
๐ Other plugins
๐ License
MIT (c) Wenxuan Zhang