- Python 2.6 or later, 3.2 or later, PyPy 2.0 or later. It is the only non-optional requirement.
- C compiler. Required to build powerline client on linux. If it is not present then powerline will fall back to shell script or python client.
socat
program. Required for shell variant of client which runs a bit faster than python version of the client, but still slower than C version.psutil
python package. Required for some segments like cpu_percent. Some segments have linux-only fallbacks forpsutil
functionality.mercurial
python package (note: not standalone executable). Required to work with mercurial repositories.pygit2
python package orgit
executable. Required to work withgit
repositories.bzr
python package (note: not standalone executable). Required to work with bazaar repositories.pyuv
python package. Required forlibuv-based watcher <config-common-watcher>
to work.i3-py
, available on github. Required for i3wm bindings and segments.
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 <config-common-term_truecolor>
if your terminal emulator supports it (see the terminal emulator support
matrix <usage-terminal-emulators>
).
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 <tips-and-tricks-urxvt>
.
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.
Linux <installation/linux> OS X <installation/osx>