Beautify Your Bash Prompt with Powerline: A Complete Step‑by‑Step Guide

Powerline Overview

Powerline started as a status‑line plugin for Vim and has expanded to support Bash, Zsh, Fish, tmux, IPython, i3, Qtile and more, offering a visually appealing and information‑rich prompt.

Installation

Powerline can be installed globally via pip. The package name on PyPI is powerline-status. sudo pip install powerline-status Because the official release is stuck at version 2.7, you may install the latest development version from the Git repository.

sudo pip install git+https://github.com/powerline/powerline.git@develop

Font Installation

Powerline uses special patched fonts. On Debian‑based systems you can install them directly: sudo apt install fonts-powerline For other systems, clone the font repository and run the installer.

git clone https://github.com/powerline/fonts.git
cd fonts
./install.sh

Configuration

Powerline provides different configuration files for various environments. Below are the typical setups for five common scenarios.

Vim
Bash
tmux
IPython
pdb

Vim

In ~/.vimrc, add the plugin via a manager:

Bundle 'powerline/powerline', { 'rtp': 'powerline/bindings/vim' }
" or
Plug 'powerline/powerline', {'rtp': 'powerline/bindings/vim'}

Alternatively, you can load the Python module directly:

python3 << endpython
from powerline.vim import setup as powerline_setup
powerline_setup()
del powerline_setup
endpython

Bash

Determine the installation path of powerline-status and source its Bash script:

POWERLINE_HOME=$(python3 -c "
import pkg_resources
try:
    dist = pkg_resources.get_distribution('powerline-status')
    print(dist.location)
except pkg_resources.DistributionNotFound:
    raise SystemExit(1)
")
if [ -d "$POWERLINE_HOME" ]; then
    source "$POWERLINE_HOME/powerline/bindings/bash/powerline.sh"
    export POWERLINE_HOME
fi

tmux

Add the following line to ~/.tmux.conf (it relies on the $POWERLINE_HOME variable set by the Bash configuration):

source "$POWERLINE_HOME/powerline/bindings/tmux/powerline.conf"

IPython

Create ~/.ipython/profile_default/ipython_config.py with these contents (for IPython 7.x):

from powerline.bindings.ipython.since_7 import PowerlinePrompts
c = get_config()
c.TerminalInteractiveShell.simple_prompt = False
c.TerminalInteractiveShell.prompts_class = PowerlinePrompts

Older IPython versions require the corresponding legacy configuration.

pdb

Run Powerline‑enhanced pdb via:

python3 -m powerline.bindings.pdb

For convenience, define an alias:

alias pdb='python3 -m powerline.bindings.pdb'

Conclusion

Powerline dramatically improves the aesthetics and information density of Bash, Vim, and tmux prompts, while the IPython and pdb integrations are primarily visual enhancements. Adopting Powerline can make the command‑line experience more pleasant and boost productivity once you become accustomed to the richer prompt.