Widget Decorations

Widget decorations are additional content that is drawn to your widget before the main content is rendered i.e. you can add drawings behind your widgets.

Types of decoration

The following decorations are available:

BorderDecoration

PowerLineDecoration

RectDecoration

Adding decorations to your widgets

All widgets available from this repo can have decorations added to them.

In addition, all widgets in the main Qtile repository can also have decorations attached. To do this, you simply need to change the import in your config file, replacing:

from libqtile import widget

with:

from qtile_extras import widget

A fuller example would look like this:

from qtile_extras import widget
from qtile_extras.widget.decorations import RectDecoration

decor = {
    "decorations": [
        RectDecoration(colour="#600060", radius=10, filled=True, padding_y=5)
    ],
    "padding": 18,
}

screens = [
    Screen(
        bottom=bar.Bar(
            [
                widget.GroupBox(**decor),
                ...
                widget.Clock(**decor),
                widget.QuickExit(**decor),
            ]
        )
    )
]

Adding decorations to user-defined widgets

You can also add the ability to draw decorations to your own widgets.

First, you need to import modify from qtile_extras.widget and use this to wrap your widget class and its configuration parameters. i.e. calling modify(WidgetClass, *args, **kwargs) will return WidgetClass(*args, **kwargs).

from libqtile.config import Screen
from libqtile.widget.base import _TextBox

from qtile_extras.bar import Bar
from qtile_extras.widget import modify


class MyTextWidget(_TextBox):
    pass


screens = [
    Screen(
        bottom=Bar(
            [
                ...
                modify(
                    MyTextWidget,
                    text="Modded widget",
                    decorations=[
                        ...
                    ]
                ),
                ...
            ]
        )
    )
]