Skip to main content

wibox

The wibox library provides the widget system for AwesomeWM/SomeWM. It includes primitive widgets, containers, layouts, and the wibar (status bar).

Upstream documentation: awesomewm.org/apidoc/popups_and_bars/wibox.html

Key Modules

ModulePurpose
wibox.widgetBase widget functionality
wibox.widget.textboxText display
wibox.widget.imageboxImage display
wibox.widget.progressbarProgress indicators
wibox.widget.sliderSlider controls
wibox.widget.systraySystem tray
wibox.containerWidget containers (margin, background, etc.)
wibox.layoutLayout containers (horizontal, vertical, etc.)
awful.wibarThe status bar

Reference

ReferenceDescription
Wibar PropertiesWibar positioning and configuration

Behavioral Notes

SomeWM uses the SNI (StatusNotifierItem) protocol for the system tray instead of X11's XEmbed. See Wayland vs X11 for details.