lain/Widgets.md

Every widget is output by a function.

Unless otherwise expressly noted, function returns a wibox.widget.textbox.

This is said because, for some widgets, function returns 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: with this you can markup textboxes using predefined variables and do whatever customization you want.

I'll give an example just to take a grasp, see the sections for all the details:

mycpu = lain.widgets.cpu({
    timeout = 4,
    settings = function()
        widgets:set_markup("Cpu " .. usage)
    end
})

• alsa
• alsabar
• bat
• borderbox
• calendar
• cpu
• fs
• imap
• maildir
• mem
• mpd
• net
• sysload
• temp
• yawn