Powerline for Debian
--------------------

Once installed, a few simple steps are needed to activate Powerline in your
favorite editor and/or shell.

bash
----

Add the following line to your ~/.bashrc file:

  . /usr/share/powerline/bindings/bash/powerline.sh

tmux
----

Add the following lines in your ~/.tmux.conf file:

  source '/usr/share/powerline/bindings/tmux/powerline.conf'

vim
---

Make sure the vim-nox package is installed, and insert the following lines in
your ~/.vimrc file:

  python from powerline.vim import setup as powerline_setup
  python powerline_setup()
  python del powerline_setup

Replace 'python' with 'python3' if appropriate.

Alternatively, if the vim-addon-manager package is installed, the following
command may be used:

  vim-addons install powerline

zsh
---

Add the following line in your ~/.zshrc file:

  . /usr/share/powerline/bindings/zsh/powerline.zsh

others
------

Powerline also supports other prompts and statuslines. See the documentation in
the python-powerline-doc for the complete list of supported programs and
installation instructions.


Configuration
-------------

The default configuration files for Powerline are located in
/usr/share/powerline/config_files

A user may customize Powerline by copying the contents of this directory into
~/.config/powerline and modifying the JSON-formatted configuration files.

Documentation for the various configuration options is found in the
python-powerline-doc package, at this URL:
file:///usr/share/doc/python-powerline-doc/html/configuration.html#main-configuration


Daemon
------

Powerline provides a daemon that can be used to improve its performance when
it is used in multiple concurrent applications. It can be started using the
following command:

  $ systemctl --user start powerline-daemon.service

To start the daemon automatically upon login:

  $ systemctl --user enable powerline-daemon.service