Widgets

General usage

Every widget is output by a function.

For some widgets, function returns a wibox.widget.textbox, for others a table to be used for notification and update purposes.

Every widget may take either a table or a list of variables as argument.

If it takes a table, you have to define a function variable called settings in it, in order to make your customizations.

To markup the textbox, call widget:set_markup(...) within settings.

You can feed set_markup with predefined arguments, see the sections for all the details.

widget is a textbox, so you can treat it like any other wibox.widget.textbox.

Here follows an example:

mycpu = lain.widgets.cpu({
    settings = function()
        widget:set_markup("Cpu " .. cpu_now.usage)
    end
})

If you want to see more complex applications, check awesome-copycats.

Some widgets use asyncshell, which is based on /bin/sh. If you use multiple shells and experience problems, try re-setting your shell here.