From: Jani Nikula <jani@nikula.org>
Date: Fri, 11 Mar 2016 12:29:06 +0000 (+0200)
Subject: getting-started: hooks
X-Git-Url: https://git.notmuchmail.org/git?p=notmuch-wiki;a=commitdiff_plain;h=00ca7e9b4ea35bb70e07f67db192bd2fc4d4c856

getting-started: hooks
---

diff --git a/getting-started.mdwn b/getting-started.mdwn
index dbc13ff..eb83c4c 100644
--- a/getting-started.mdwn
+++ b/getting-started.mdwn
@@ -87,6 +87,14 @@ There are two ways to deliver and index messages:
 
 ## Automation Via Hooks
 
+Notmuch supports running [[user defined hooks|manpages/notmuch-hooks-5]] before
+or after certain commands. Hooks can be arbitrary executable programs or
+scripts. For example, if you always run your mail delivery tool first and
+`notmuch new` after that, you can run the tool from Notmuch `pre-new` hook, and
+simply run `notmuch new` to do both. If you always do some tagging after
+indexing of new messages, you may want to set up a `post-new` or `post-insert`
+hook to do that automatically.
+
 ## Backing up and Restoring the Database
 
 ## Removing Notmuch