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:

powerline-lemonbar

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

powerline-lemonbar --height 16 -- -a 40 -f 'DejaVu Sans Mono-11' -f 'PowerlineSymbols-12' -f 'FontAwesome-11'"

Note that, if you don’t specify any options, powerline-lemonbar will default to the above.

To run with i3, simply exec this in the i3 config file:

exec powerline-lemonbar

Running the binding in i3-mode will require i3ipc.

See the lemonbar documentation for more information and options.

To enhance the global menu, add the following to your .bashrc:

if [ -n "$GTK_MODULES" ]; then
    GTK_MODULES="${GTK_MODULES}:appmenu-gtk-module"
else
    GTK_MODULES="appmenu-gtk-module"
fi

if [ -z "$UBUNTU_MENUPROXY" ]; then
    UBUNTU_MENUPROXY=1
fi

export GTK_MODULES
export UBUNTU_MENUPROXY

Further, add the following line to your i3 config

exec --no-startup-id powerline-globmenu

---

All powerline-lemonbar arguments:

powerline-lemonbar [--i3] [--no_i3] [--use_defaults] [--clicks]
                   [--no_clicks] [--alt_output] [--height=PIXELS]
                   [--correction=C] [--relative_height]
                   [--interval=SECONDS] [--bar_command=CMD]
                   [--] [ARGS]…

--i3

Unused.

--no_i3

Don’t Subscribe for i3 events.

--use_defaults, -d

Do also supply the bar with the default extra arguments.

--clicks

Unused.

--no_clicks

Don’t redirect lemonbar output to /bin/sh

--alt_output, -o

Use alternative output detection

--height, -H PIXELS

Bar height. Defaults to 18.

--correction, -c C

Correction factor for default font sizes.

--relative_height, -R

Interpret the given height as relative height in percent.

--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. Defaults to -a 40 -b -f ‘DejaVu Sans Mono-{height*.6}’ -f ‘PowerlineSymbols-{height*.75}’ -f ‘FontAwesome-{height*.65}’.

-h, --help

Display help and exit.