khal-reminder

A reminder tool for khal that polls upcoming calendar events and sends desktop notifications via dunst.

Requirements

• dunst — a lightweight notification daemon. khal-reminder uses dunstify (bundled with dunst) to display notifications with action buttons. Make sure dunst is running and configured to show actions.
• Gauche — Scheme script interpreter (gosh).
• khal — must be installed and configured.

Usage

khal-reminder

Add it to a cron job or a systemd timer to run periodically (e.g., every 20 minutes). For example, a crontab entry:

*/20 * * * * /path/to/khal-reminder

Dunst Configuration

For action buttons to work, dunst needs to be built with actions support. Here is an example dunst config section:

[global]
    # Enable markup and actions
    markup = full
    # Hide notifications when clicked (set to none to keep them open)
    mouse_middle_click = close_current
    # Left/right click trigger action buttons
    mouse_left_click = do_action
    mouse_right_click = do_action

# Per-app settings for khal-reminder
[khal_reminder]
    appname = khal-reminder
    icon = x-office-calendar
	format = "<b>%s</b>\n%b"
    # Keep reminders visible until the user interacts
    override_dbus_timeout = 0

Place this in your dunst config file (usually ~/.config/dunst/dunstrc) and restart dunst.