lain/calendar.md

<- widgets

Attaches a calendar notification to a widget.

lain.widgets.calendar:attach(widget, args)

• Left click: switch to previous month.
• Right click: switch to next month.

args is an optional table which can contain:

Variable	Meaning	Type	Default
icons	Path to calendar icons	string	lain/icons/cal/white
font_size	Calendar font size	int	12
fg	Calendar foreground color	string	beautiful.fg_normal
bg	Calendar background color	string	beautiful.bg_normal
position	Calendar position	string	"top_right"

position possible values are defined here.

Notification will show an icon displaying current day, and formatted output from cal with current day highlighted.

You can call the notification with a key binding like this:

awful.key({ altkey }, "c", function () lain.widgets.calendar:show(7) end),

where altkey = "Mod1" and show argument is an optional integer, meaning timeout seconds.