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.
The following decorations are available:
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),
]
)
)
]
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=[
...
]
),
...
]
)
)
]