LinuxCommandLibrary

powerline

Statusline plugin for shells and editors

TLDR

Start daemon

$ powerline-daemon --replace
copy
Use with bash
$ powerline-daemon -q && PROMPT_COMMAND="powerline-bash-prompt"
copy
Check configuration
$ powerline-lint
copy
Reload configuration
$ powerline-daemon --kill && powerline-daemon
copy

SYNOPSIS

powerline ext side [options]
powerline-daemon [options]

DESCRIPTION

Powerline is a statusline plugin for vim, tmux, zsh, bash, and other applications. It provides informative, visually appealing status displays showing contextual information such as Git branch and status, Python virtualenv, current working directory, hostname, and battery level.
The tool runs as a daemon process for performance, communicating with shell prompts and editor plugins via a client. Configuration files in ~/.config/powerline/ control themes, color schemes, and which segments appear in each context. A powerline-compatible font is required for the special glyphs used in the status bar separators.

PARAMETERS

-q, --quiet

Suppress output.
--replace
Replace running daemon.
--kill
Kill daemon.
-p, --config-path path
Configuration path.

EXAMPLES

$ # Start daemon
powerline-daemon -q

# Check config
powerline-lint

# Test shell prompt
powerline shell left

# Install for bash (in .bashrc)
powerline-daemon -q
PROMPT_COMMAND="_update_ps1; $PROMPT_COMMAND"
copy

CONFIGURATION

~/.config/powerline/config.json

Main configuration file defining default theme, colorscheme, and per-extension overrides for shell, tmux, vim, and other contexts.
~/.config/powerline/themes/
Theme files controlling which segments appear in each statusline context (shell prompt, tmux status bar, vim statusline).
~/.config/powerline/colorschemes/
Color scheme files mapping segment highlight groups to terminal colors.

SHELL SETUP (bash)

$ # In ~/.bashrc
if [ -f /usr/share/powerline/bindings/bash/powerline.sh ]; then
    source /usr/share/powerline/bindings/bash/powerline.sh
fi
copy

TMUX SETUP

$ # In ~/.tmux.conf
source /usr/share/powerline/bindings/tmux/powerline.conf
copy

CAVEATS

Requires powerline-compatible font. Configuration in ~/.config/powerline/. Daemon improves performance.

HISTORY

Powerline was created by Kim Silkebækken originally as a vim plugin, later expanded to shells and tmux.

SEE ALSO

starship(1), oh-my-zsh(1), tmux(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community