Provides notifications for scheduled or deadlined agenda entries.
Check for and display agenda entries that are active and due.
org-alert parses your org agenda for the current day looking for any
headlines that are scheduled or contain a deadline that aren't marked
with any of your DONE
state keywords.
Enable periodic deadline checking.
Sets a timer which periodically calls org-alert-check
. The
interval can be set by changing the org-alert-interval
(defaults to
300s).
Disable periodic deadline checking.
Cancels any timers set up with the org-alert-enable
function.
Installing via melpa is a simple as:
package-install
RET org-alert
RET
(use-package org-alert
:ensure t)
Clone the repo somewhere you will remember and then add it to your load path.
(add-to-list 'load-path "path/to/org-alert")
(require 'org-alert)
org-alert uses the excellent
alert package from John Wiegley
to present its alerts. This defaults to using the Emacs message
function for displaying notifications, to change it to something
prettier set the alert-default-style
variable to one of the options
listed here.
To get system notifications like the screenshot use the following:
(setq alert-default-style 'libnotify)
You can even define your own styles!
org-alert-interval
determines how often org-alert checks your agenda file, and
org-alert-notify-cutoff
controls how long before a scheduled event a
notification should be sent. org-alert-notify-after-event-cutoff
controls how
long after a scheduled event to continue sending notifications.
The snippet:
(setq org-alert-interval 300
org-alert-notify-cutoff 10
org-alert-notify-after-event-cutoff 10)
will set org-alert to check your agenda file every 5 minutes (300 seconds), start notifying you of a scheduled event 10 minutes before the event, and stop notifying you of the event 10 minutes after the scheduled time has passed.
You can also set the cutoff on a per-item basis using the org-alert-cutoff-prop
property, which defaults to REMINDERN
. For example, the entry
* TODO remindern test
SCHEDULED: <2023-05-20 Sat 09:55>
:PROPERTIES:
:REMINDERN: 15
:END:
will alert 15 minutes before the scheduled time, regardless of the value of
org-alert-notify-cutoff
. If you happen to be using
org-wild-notifier.el, you
might want to use WILD_NOTIFIER_NOTIFY_BEFORE
instead of REMINDERN
.
org-alert uses the title *org*
by default. You can set this to
something else by changing the org-alert-notification-title
variable. Use this if you'd like to customize the display of org
notifications when using a daemon such as
dunst.
org-alert searches for agenda entries with 'Sched' or 'Deadline' word
by default. You can set any other regexp you wish using
the org-alert-match-string
variable.
org-alert searches for times within an org subtree using the
org-alert-time-match-string
variable, which defaults to
"\\(?:SCHEDULED\\|DEADLINE\\):.*<.*\\([0-9]\\{2\\}:[0-9]\\{2\\}\\).*>"
Like org-alert-match-string
, you can set this in your config. For example, if
you have nested SCHEDULED items like:
* task 1
SCHEDULED: <2022-12-08 Thu 07:00>
Do something
** task 1a
SCHEDULED: <2022-12-08 Thu 15:30>
you may want to use a non-greedy regular expression as suggested by hai5 to capture the first one rather than the second:
(setq org-alert-time-match-string
"\\(?:SCHEDULED\\|DEADLINE\\):.*?<.*?\\([0-9]\\{2\\}:[0-9]\\{2\\}\\).*>")
- Notification priorities based on headline type (scheduled vs deadline)