task.md

   1 [<- widgets](https://github.com/copycat-killer/lain/wiki/Widgets)
   2
   3 Attaches a [taskwarrior](http://taskwarrior.org/projects/show/taskwarrior) notification to a widget, and lets to add/search tasks from the promptbox.
   4
   5     lain.widgets.contrib.task:attach(widget, args)
   6
   7 `args` is an optional table which can contain:
   8
   9 Variable | Meaning | Type | Default
  10 --- | --- | --- | ---
  11 `font_size` | Calendar font size | int | 12
  12 `fg` | Calendar foreground color | string | `beautiful.fg_normal`
  13 `bg` | Calendar background color | string | `beautiful.bg_normal`
  14 `position` | Calendar position | string | "top_right"
  15 `timeout` | Notification timeout seconds | int | 7
  16
  17 `position` possible values are defined [here](http://awesome.naquadah.org/doc/api/modules/naughty.html#notify).
  18
  19 Notification will show the output of `task` command.
  20
  21 You can call the notification with a key binding like this:
  22
  23     awful.key({ modkey, altkey }, "t", lain.widgets.contrib.task.show),
  24
  25 where ``altkey = "Mod1"``.
  26
  27 And you can prompt to add/search a task with key bindings like these:
  28
  29     awful.key({ modkey,         }, "t", lain.widgets.contrib.task.prompt_add),
  30     awful.key({ modkey, "Shift" }, "t", lain.widgets.contrib.task.prompt_search),