tmux-net-speed

March 17, 2026 ยท View on GitHub

TPM License

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

OptionDefaultDescription
@net_speed_interfaces(empty)Space-separated list of interfaces to monitor. If empty, all non-virtual interfaces are used.
@upload_speed_format%7sprintf format string for upload speed
@download_speed_format%7sprintf 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