Powerline Documentation

  • Put POWERLINE_ROOT into environment could simplify the configurations.

Installation with zsh

The appearance of powerline in the shell is completely different from powerlevel10k, there is currently no alternative.

  • Use pip3 install powerline-status to install with pip.
  • pip show powerline-status to find the installation path.
  • Add .{repository_root}/powerline/bindings/zsh/powerline.zsh to the shell configuration.
. "$(pip3 show powerline-status | grep 'Location: ' | cut -d ' ' -f 2)/powerline/bindings/zsh/powerline.zsh"

The following error may occur:

/home/sghuang/.local/lib/python3.10/site-packages/powerline/bindings/zsh/powerline.zsh:210: no such file or directory: /home/sghuang/.local/lib/python3.10/site-packages/scripts/powerline-config

We need to create a hard link. The config file is located at bin/powerline-config.

However, the shell prompts zsh: permission denied. We also need to change the mode of the copied file.

Same issue here: OSX - zsh install - permission denied #1643

This is due to not setting the path to contain the powerline executable.

export PATH="$HOME/.local/bin:"$PATH
powerline-daemon -q

Setting up Vim

The installation is very tedious, try other alternatives that are specific for Vim.

Introduction to Powerline the statusline plugin for VIM

WARNING

powerline` does NOT work with Neovim AT ALL! Add support for NeoVim #1287

Installation with tmux

Need to install it in a managed Python env.

uv tools install powerline-status # or
pipx install powerline-status