A notification daemon of events stored in directories

Those directories will be monitored for change in order to allow you to use solution like vdirsyncer to sync your CalDAV server with your local filesystem.

For a list of changes see the changelog

remhind can be installed through PyPI using pip.

pip install remhind

remhind use a toml configuration file indicating which directories holds your event files. Here's a simple example:

[calendars]
    [calendars.test]
    name = "Test"
    path = "~/projets/perso/remhind/test_calendar"

remhind displays notification for calendar events even if they don't have an alert set. By default his happens at the time the event starts but can be configured in the configuration file as in the following example.
Note that the default is [ 0 ] and you have to include 0 in your configuration if you want an alert at the time of the event.

[notifications]
    alert_before_event_minutes = [ 15, 5, 0 ]
[calendars]
    [calendars.test]
    name = "Test"
    path = "~/projets/perso/remhind/test_calendar"

You can can specify a timeout for your notifications in the config file. Allowed values are

• DEFAULT - Use your notification tools' default timeout. This is the same as not setting any option
• NEVER - Notification will be displayed until clicked away
• 5000 - A number will be interpreted as timeout in milliseconds. The notification will automatically disappear after this time.

[notifications]
    timeout = "NEVER"
[calendars]
    [calendars.test]
    name = "Test"
    path = "~/projets/perso/remhind/test_calendar"

If you are not satisfied with the look of the default notifications you can style them yourself. The template engine is jinja2 and the template files used can be specified with the --title-template and --message-template argument.
They default to ~/.config/remhind/title.j2 and ~/.config/remhind/message.j2. .config standing for your xdg config directory

• alarm: alarm,
• in_time: "in X days Y hours Z minutes" - a human readable version of time_until_alert,
• time_until_alert: shorthand for alarm.due_date - alarm.date
• now: datetime.now()

If no template file is present the following default templates will be used

{{ alarm.due_date.hour }}:{{ alarm.due_date.minute }} {{alarm.message}}

Alarm

You can specify a list of alert messages which you want replaced by the events summary. Not that the message is converted to upper case before being checked make sure to write your entries in all upper case.

This is useful for example when using khal. khal sets reminders without a specific message to have the message None. The following example will display those khal reminders with the event summary instead.

[notifications]
    override_alert_message = [ "NONE" ]

This work has been inspired by the work of the pimutils group