Window manager widgets

Awesome widget

Note

Powerline currently only supports awesome 3.5 and 4+.

Note

The Powerline widget will spawn a shell script that runs in the background and updates the statusline with awesome-client.

Add the following to rc.lua, where {repository_root} is the absolute path to Powerline installation directory (see repository root):

package.path = package.path .. ';{repository_root}/powerline/bindings/awesome/?.lua'
require('powerline')

Then add the powerline_widget to wibox:

-- awesome3.5
right_layout:add(powerline_widget)

-- awesome4+
s.mywibox:setup {
...
  { -- Right widgets
    ...
    powerline_widget,
  },
}

Qtile widget

Add the following to ~/.config/qtile/config.py:

from libqtile.bar import Bar
from libqtile.config import Screen
from libqtile.widget import Spacer

from powerline.bindings.qtile.widget import PowerlineTextBox

screens = [
    Screen(
        top=Bar([
                PowerlineTextBox(update_interval=2, side='left'),
                Spacer(),
                PowerlineTextBox(update_interval=2, side='right'),
            ],
            35 # width
        ),
    ),
]

lemonbar (formerly bar-aint-recursive)

To run the bar simply start the binding script:

python /path/to/powerline/bindings/lemonbar/powerline-lemonbar.py

You can specify options to be passed to lemonbar after --, like so:

python /path/to/powerline/bindings/lemonbar/powerline-lemonbar.py –height 16 – -f “Source Code Pro for Powerline-9”

to run with i3, simply exec this in the i3 config file and set the --i3 switch:

exec python /path/to/powerline/bindings/lemonbar/powerline-lemonbar.py –i3

Running the binding in i3-mode will require i3ipc (or the outdated i3-py).

See the lemonbar documentation for more information and options.

All powerline-lemonbar.py arguments:

powerline-lemonbar.py [--i3] [--height=PIXELS] [--interval=SECONDS]
                      [--bar-command=CMD] [--] [ARGS]…

--i3

Subscribe for i3 events.

--height PIXELS

Bar height.

--interval, -i SECONDS

Refresh interval.

--bar-command, -C CMD

Name of the lemonbar executable to use.

ARGS

Extra arguments for lemonbar. Should be preceded with -- argument in order not to be confused with script own arguments.

-h, --help

Display help and exit.

I3 bar

Add the following to ~/.config/i3/config:

bar {
    status_command python /path/to/powerline/bindings/i3/powerline-i3.py
    font pango:PowerlineFont 12
}

where PowerlineFont is any system font with powerline support.