2.2 KiB
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 |
|---|---|---|---|
cal |
custom call for cal * |
string | "/usr/bin/cal" |
post_cal |
post cal processing, if needed |
string | "" |
icons |
Path to calendar icons | string | lain/icons/cal/white |
font |
Calendar font | string | beautiful.font |
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" |
scr_pos |
Notification screen | int | 1 |
followmouse |
Notification behaviour | boolean | false |
* cal program options may vary depending on the operating system: you may need to set this variable properly (/usr/bin/cal -h for instance) in order to display the current day highlighting.
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.
You can also call it defining a notification screen with a third argument like this:
awful.key({ altkey }, "c", function () lain.widgets.calendar:show(7, 0, my_scr_number) end),
In multiple screen setups, the default behaviour is to show a visual notification pop-up window on the first screen when the widget is hovered with the mouse. By setting followmouse to true it will be shown on the same screen containing the widget.
Note
Naughty notification requires font to be monospaced, in order to correctly display the output.