org-alert
Provides notifications for scheduled or deadlined agenda entries.
Command overview
org-alert-check
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.
org-alert-enable
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).
org-alert-disable
Disable periodic deadline checking.
Cancels any timers set up with the org-alert-enable
function.
Installation
Via MELPA
Installing via melpa is a simple as:
package-install
RET org-alert
RET
Manually
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)
Configuration
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!
Custom titles
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 customise the display of org
notifications when using a daemon such as
dunst.
Custom regexp for searching agenda entries
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-headline-regexp
variable.
TODOs
- Notification priorities based on headline type (scheduled vs deadline)