Note
Until mercurial and bazaar support Python-3 or PyPy powerline will not support repository information when running in these interpreters.
This project is currently unavailable from PyPI due to a naming conflict with an unrelated project, thus you will have to use the following command to install powerline with pip:
pip install --user git+git://github.com/Lokaltog/powerline
. You may also choose to clone powerline repository somewhere and use
pip install -e --user {path_to_powerline}
, but note that in this case pip will not install powerline executable and you will have to do something like
ln -s {path_to_powerline}/scripts/powerline ~/.local/bin
(~/.local/bin should be replaced with some path present in $PATH).
Note
If your ISP blocks git protocol for some reason github also provides ssh (git+ssh://git@github.com/Lokaltog/powerline) and https (git+https://github.com/Lokaltog/powerline) protocols. git protocol should be the fastest, but least secure one though.
To install release version uploaded to PyPI use
pip install powerline-status
Powerline uses several special glyphs to get the arrow effect and some custom symbols for developers. This requires that you either have a symbol font or a patched font on your system. Your terminal emulator must also support either patched fonts or fontconfig for Powerline to work properly.
You can also enable 24-bit color support if your terminal emulator supports it (see the terminal emulator support matrix).
There are basically two ways to get powerline glyphs displayed: use PowerlineSymbols.otf font as a fallback for one of the existing fonts or install a patched font.
This method is the fallback method and works for every terminal, with the exception of rxvt-unicode.
Download the font of your choice from powerline-fonts. If you can’t find your preferred font in the powerline-fonts repo, you’ll have to patch your own font instead.
After downloading this font refer to platform-specific instructions.