[[!img notmuch-logo.png alt="Notmuch logo" class="left"]]
+# Tips and Tricks for using Notmuch with vim
-Notmuch is a great mail indexing tool that can also be used *in conjunction*
-with existing Mail User Agents (MUA) instead of replacing them. The advantage of
-such mixed solutions is that users can benefit from notmuch features (such as
-full-text search and thread reconstruction) without *having to* change MUA.
-
-A popular geek MUA is [the Mutt e-mail client](http://www.mutt.org); integrating
-notmuch with Mutt is not seamless, but fairly straightforward. There are two
-principal possibilities, either using a patched mutt that handles internally
-notmuch, or use a sets of scripts/handler within mutt to achieve something close.
+Tips for using Notmuch with vim; these may be applicable when using vim with
+[[notmuch-mutt]], [mutt-kz](https://github.com/karelzak/mutt-kz), or
+[notmuch-vim](http://git.notmuchmail.org/git/notmuch/blob/HEAD:/vim/README).
[[!toc levels=2]]
for me. And I never could test the vala-based code. So I updated the notmuch_addresses code to
use a cache to be able to make better matches and still be lightning fast.
-And finally, [I needed](http://i.got.nothing.to/blog/2013/03/20/how-i-learned-to-stop-worrying-and-love-the-mail/) to have a way to autocomplete my recipients' addresses
+And finally, [I needed](http://i.got.nothing.to/blog/2013/03/20/how-i-learned-to-stop-worrying-and-love-the-mail/) to have a way to autocomplete my recipients' addresses
automagically from within `vim`. So that's why I created the [notmuch_abook](https://github.com/guyzmo/notmuch-abook) code.
You can either install it as a plugin in vim, using vundle:
To configure the address book, append to `~/.notmuch-config` the following:
- % cat > ~/.notmuch-config << EOF
-
+ % cat >> ~/.notmuch-config << EOF
+
[addressbook]
path=/home/YOURUSERNAME/.notmuch-abook.db
backend=sqlite3
If you're using vim, when you edit a mail having a filetype set to mail, you will be
able to open a completion menu when you do <C-x><C-u> at every address header.
-