Package: maildirwatch
maildirwatch - Watch Maildir for new mail and display notificationsThis program allows you to watch aMaildirfor incoming email and display
notifications when new messages arrive.The displayed notifications are interactive - programs can be run when the user
clicks on them.InstallationInstallation from PyPI:pip3 install --user maildirwatchPython3 is required.Note:PyGObjectis a dependency of this program.  To install it, you might
have to install GObject development libraries on your system.  On Debian, the
packageslibgirepository1.0-devandgir1.2-notify-0.7provide these
libraries.UsageUse themaildirwatchcommand, or:python3 -m maildirwatchThe program will run forever or until you interrupt it withCtrl-C.To list available options, run:maildirwatch --helpConfigurationThe program looks for the configuration file in$XDG_CONFIG_HOME/maildirwatch.confor~/.config/maildirwatch.confifXDG_CONFIG_HOMEis not defined.The configuration file is in Python’s standard config format (understood by theconfigparsermodule).Global optionsThese options should be put in the[global]section.maildirThe directory to scan for maildirs.  Default value:~/Maildir.ignoreComma-separated list of maildir patterns to ignore.  Each pattern must be infnmatchstyle.  By default, no maildirs are ignored.whitelistComma-separated list of maildir patterns to watch, even if they’re matched byignore.You can explicitly select maildirs to watch by settingignoreto**/**andwhitelistto patterns that you want to watch,
e.g.*Inbox*,*Important*.inhibit-commandCommand to run to check if notifications should be inhibited.  If the command
exits with 0, the notification is NOT displayed and only a message is logged.
Otherwise the notification is displayed.If this is undefined, notifications are always displayed.ActionsEach action is a path to a program and a list of arguments.  Every action also
has a name that is displayed to the user.Actions are typically displayed as text buttons below the notification body.
When the user clicks on the action button, the action program is started.Action definitions must be put in[actions]section.  Each action is
defined like this:action name = /path/to/program arg1 arg2 arg3...One action name is special - thedefaultaction.  The default action’s
value should be the name of another action instead of path to a program.  The
program associated with default action is run when the user clicks on the
notification itself, not an action button.Example configurationBelow is an example configuration file that modifies path to the Maildir,
ignores spam folder, defines two actions and disables notifications if VLC is
running:[global]
maildir = ~/mail
ignore = *Spam,*foo/bar*
inhibit-command = pgrep vlc

[actions]
default = Show mu4e
Show mu4e = emacs -f mu4e
Start thunderbird = thunderbirdLicenseCopyright (C) 2019 Michał Krzywkowski

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.