This is a simple program that displays desktop notifications for unread mail (or actually any search query) in the notmuch database. The notification can optionally have a button to run a mail client.
When a message is shown in a notification, it is internally marked as 'recently seen' and not shown again for two days (configurable).
The program requires Python 3, setuptools, pygobject and notmuch. It can be installed together with its dependencies using:
pip install .To use, execute muchnotify after new mail is indexed (for example in a post-new hook). The program forks and stays in the background while the notification is active. If upon launch a notification is already active, it is updated.
Configuration is stored in ~/.config/muchnotify/muchnotify.cfg, which is created on first run. Settings that can be set there:
- query
The notmuch search query for the messages. Default is
is:unread and is:inbox.- mail_client
The command to launch the preferred mail client. If empty, the button isn't shown. Default is
gnome-terminal -x mutt -y.- recency_interval_hours
Each message is notified about at most once in this time interval. Default is
48.- hidden_tags
Tag names that are not shown in the notification. Default is
inbox unread attachment replied sent encrypted signed.