Replace your tmux status bar with one that shows battery level, CPU load, and the current Git branch at a glance.
Display the currently playing Spotify or MPD track in your terminal status bar without leaving the terminal.
Show live network upload/download speeds and your external IP address in your tmux session.
Create a custom status bar segment in any language to surface any information you want in tmux.
Requires a Nerd Font installed in your terminal to render arrow separators, some segments need extra tools like jq, curl, or wget.
tmux-powerline is a plugin for tmux, which is a terminal multiplexer: a program that lets you run multiple terminal sessions inside a single window, split into panes, and keep sessions running when you disconnect. This plugin replaces tmux's plain status bar (the line of text at the bottom of the screen) with a more informative, visually styled bar made up of configurable segments separated by arrow-shaped dividers in the Powerline visual style. Each segment in the status bar shows one piece of information, and you choose which segments to include and in what order. The list of available segments is long: current date and time, system load and CPU usage, battery level, weather, network speeds, new mail counts from Gmail or local mailboxes, the song currently playing in several music players including Spotify and MPD, the current Git branch in your working directory, your local and external IP addresses, and more. Segments that have nothing to show, like a now-playing segment when no music is running, disappear automatically rather than taking up space. The plugin is written entirely in Bash, so it requires no compiled code or unusual runtime dependencies. The base installation needs tmux version 2.9 or later and Bash 3.2 or later. Some individual segments have their own dependencies: for example, the weather segment needs the jq and curl command-line tools, and the Gmail segment needs wget. You also need a Nerd Font installed in your terminal so that the arrow separator symbols and any icon glyphs render correctly. Installation uses a tmux plugin manager called tpm. You add one line to your tmux configuration file pointing to this repository, then press a key combination to install it. After that you generate a personal configuration file and edit it to choose which segments to show on the left and right sides of the status bar. Custom themes are supported, and you can write your own segments in any language as long as they output the right format. The project has been around for many years and is actively maintained with help from a co-maintainer.
← erikw on gitmyhub — every repo by this author, as a profile.
Verify against the repo before relying on details.