doomemacs/modules/email/notmuch/README.org

email/notmuch

• Table of Contents
• Description
  • Module Flags
  • Plugins
• Prerequisites
  • MacOS
  • Arch Linux
  • NixOS
  • openSUSE
  • Debian/Ubuntu
• Features
• Configuration
  • Gmailier
  • offlineimap
  • mbsync
  • notmuch
• Troubleshooting

Table of Contents   TOC

• Description

  • Module Flags
  • Plugins

• Prerequisites

  • MacOS
  • Arch Linux
  • NixOS
  • openSUSE
  • Debian/Ubuntu
• Features

• Configuration

  • Gmailier
  • offlineimap
  • mbsync
  • notmuch
• Troubleshooting

Description

This module makes Emacs an email client, using notmuch.

Module Flags

• This module install no module flags.

Plugins

• notmuch
• org-mime

Prerequisites

This module requires:

• Either gmailieer (default), mbsync or offlineimap (to sync mail with)
• notmuch, to index and tag your downloaded messages.
• afew, optionally to initially tag your downloaded messages.

TODO MacOS

TODO Arch Linux

NixOS

environment.systemPackages = with pkgs; [
    notmuch
    # And one of the following
    gmailieer
    isync
    offlineimap
];

An example of setting up mbsync and notmuch with home-manager

TODO openSUSE

TODO Debian/Ubuntu

TODO Features

Configuration

TODO Gmailier

offlineimap

This module uses Gmailier by default. To use offlineimap, change +notmuch-sync-backend:

(setq +notmuch-sync-backend 'offlineimap)

Next, you need to write a configuration file for offlineimap. Mine can be found in my dotfiles repository. It is configured to download mail to \~/.mail. I use unix pass to securely store my login credentials. You can find a very detailed configuration here.

Next you can download your email with offlineimap -o. This may take a while, especially if you have thousands of mails.

You can now proceed with the mu and mu4e section.

mbsync

This module uses Gmailier by default. To use mbsync, change +notmuch-sync-backend:

(setq +notmuch-sync-backend 'mbsync)

The steps needed to set up mu4e with mbsync are very similar to the ones for offlineimap.

Start with writing a \~/.mbsyncrc. An example for GMAIL can be found on pragmaticemacs.com. A non-GMAIL example is available as a gist here. The manual page contains all needed information to set up your own.

Next you can download your email with mbsync --all. This may take a while, but should be quicker than offlineimap ;).

You can now proceed with the mu and mu4e section.

notmuch

You should have your email downloaded already. If you have not, you need to set Gmailier, offlineimap or mbsync up before you proceed.

Before you can use notmuch, you need to index your email initially.

notmuch new

Troubleshooting