N E V E R M O R E
Nevermore is an experimental emacs email interface for Notmuch. It provides:
- Interactive search
- Tag editing with autocompletion
- Mail address completion (via company-mode)
- Junk mail filtering (via bogofilter)
Nevermore is based on Notmuch, so you'll need to install Notmuch (including emacs support), and run it once from the command line to configure it.
You'll also need the peg package.
Then drop the source files (nm.el, nm-dateparse.el, and nm-company.el) into your load-path and place this in your .emacs or init.el file:
Mail address completion
Nevermore uses company-mode for mail address completion. After installing company-mode, add
to your init file. Nevermore will automatically derive completion candidates from your mail store, and display them as you type in a To:, Cc:, or Bcc: field. Note that company-mode has a setting,
that controls the number of characters you must type before autocompletion will take effect, and it defaults to three (3) characters. You may set this as low as 1 character.
Junk mail filtering
Nevermore uses bogofilter for junk mail filtering. It works out of
the box as long as you have bogofilter installed. Type
J to mark a
thread or message as junk.
Start reading mail with
This will bring up a summary window with the results of the default
search, which is
tag:inbox. Nevermore can search for threads or
individual messages; by default it searches for individual messages.
You can toggle between thread search and message search by hitting
You can navigate in the search results with the usual emacs commands
C->, etc.) You can also type
n to move to
the next result or
p to move to the previous result.
To view a message or thread, hit
RET. In message search
mode, the message will appear in a window below the search results.
SPC to read more of the message,
DEL to back up. Hit
to get rid of the message window.
In thread search mode,
RET will replace the search results
buffer with a buffer showing the selected thread. You can use the
usual keys from notmuch to navigate the thread. Hit
q to exit the
thread and return to the results buffer.
To start a new search, hit
/. This will bring the current search to
the minibuffer, where you can edit it. As you change the search, the
results buffer is updated in real time. When you are satisfied with
the query, hit
RET to get back into the results buffer.
The Notmuch query syntax is documented here.
In the minibuffer you can navigate your search history with
Focusing on a thread
In message search mode, there is a separate result for each message in
a thread. Sometimes it's useful to see all of the messages of a
thread, while excluding messages from other threads; hit
T to change
your search query to one that shows just those messages.
Nevermore's underlying query engine is Xapian. Xapian's behaviour during incremental search can take a little getting used to. Xapian uses stemming so that the queries
are really the same query; they search for variants of look (look, looked, looking, etc.) . However,
is a different query that probably has no results, since it is not an English word. Therefore, if you search incrementally for "looking", when you have typed just "look" you will get the full result set, but when you go on and add an "i", you'll get an empty result set. Eventually you will hit "looking" and you'll see the full result set again.
You can use a wildcard character to avoid this behaviour:
will search for "looki" and any extension of "looki". One way to use
this is to start a query ending in "*", then back up a character
C-b) and continue typing your query. Note that
can have fewer results than
because the later query uses stemming but the former does not.
m to send a new message. In message search mode you can hit
R to reply-all, and
f to forward a message. Nevermore
currently does not have a notion of the "current" message of thread,
so these commands don't make sense in thread search mode. However, if
you are viewing a thread,
R work just as in notmuch.el.
a to archive a result, which simply moves it out of
d to delete a result, which simply moves it out of
Tags are displayed at the right of every result. You can edit the
tags in the minibuffer by hitting
t. You can autocomplete tags in
the minibuffer with
Nevermore has rudimentary support for snoozing messages and threads.
In the results buffer hit
s to snooze a result. The result will be
moved out of
tag:later. Note that if you are
tag:inbox, the result will not immediately disappear
from your search results; you need to re-run the search, which can be
done by hitting
A snoozed result will be moved back to
tag:inbox the following
morning. You can change the default snooze target by changing
nm-snooze-default-target (it starts out as
tomorrow 6am). If you
supply a prefix argument to the snooze command (
C-u s), nevermore
will prompt you for a target.
Nevermore supports searching for web page archives maintained in jotmuch. Invoke nevermore with
to search your jotmuch database. Hitting
RET on a result will open
the original web page in your browser.