Repolode
Submit
erikw

erikw/tmux-powerline

A tmux plugin that adds a hackable, powerline-style status bar built from segments, written in pure bash.

View on GitHub
Stars
3,846
Forks
535
Open issues
0
Last commit
30 days ago

What is it?

tmux-powerline is a tmux plugin that replaces the default status bar with a Powerline-style bar made of independent segments. Each segment shows one piece of information, such as the current git branch, system load, battery level, weather, network addresses, or the track playing in a music player. Segments can be arranged into custom themes and turned on or off per setup.

The plugin is implemented purely in bash, so it has few system requirements. Segments are plain shell scripts, and users can write their own in any language by wrapping them in a shell script. Configuration, themes, and custom segments live in a separate user directory so they survive plugin updates. It installs through tpm and needs a Nerd Font for its symbols.

Key features

  • 01Modular segments for git, system load, battery, weather, IP addresses, and more.
  • 02Music players and mail clients can be shown through built-in segments.
  • 03Custom themes let you choose which segments appear on the left and right.
  • 04Custom segments can be added in a user directory that is kept separate from the plugin.
  • 05Written in pure bash with no runtime dependencies beyond tmux and bash.

Use cases

  • Showing git branch and system stats in the tmux status bar while coding in terminal sessions.
  • Displaying the now-playing track or unread mail count without leaving the terminal.
  • Building a personalized Powerline-style status bar that matches your terminal theme.

Quick start

  1. 1

    Install tpm (Tmux Plugin Manager) and make sure it works

  2. 2

    Add the plugin line to tmux.conf

    set -g @plugin 'erikw/tmux-powerline'
  3. 3

    Install the plugin with the tpm keybinding prefix then I

Things to know

  • Requires a Nerd Font for the default symbols.
  • Some segments need extra tools such as jq, curl, or ccusage, and some need an API key.

In collections

CLI & terminal tools

Topics

#tmux#bash#statusbar#powerline#terminal#tmux-plugin#shell#configuration#dynamic#hacktoberfest

FAQ

What is tmux-powerline?
A tmux plugin that adds a hackable, powerline-style status bar built from segments, written in pure bash. tmux-powerline is a tmux plugin that replaces the default status bar with a Powerline-style bar made of independent segments. Each segment shows one piece of information, such as the current git branch, system load, battery level, weather, network addresses, or the track playing in a music player. Segments can be arranged into custom themes and turned on or off per setup.
Is tmux-powerline free to use? What license does it have?
tmux-powerline is open source under the BSD-3-Clause license. Check the license terms before using it in commercial products.
Is tmux-powerline still maintained?
Actively maintained. The last commit to tmux-powerline was on Oct 8, 2026.
What can I use tmux-powerline for?
Showing git branch and system stats in the tmux status bar while coding in terminal sessions. Displaying the now-playing track or unread mail count without leaving the terminal. Building a personalized Powerline-style status bar that matches your terminal theme.
How do I install tmux-powerline?
Install tpm (Tmux Plugin Manager) and make sure it works Add the plugin line to tmux.conf: set -g @plugin 'erikw/tmux-powerline' Install the plugin with the tpm keybinding prefix then I
Where can I get tmux-powerline?
The source code and installation instructions are on GitHub: https://github.com/erikw/tmux-powerline

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects