gitback/doomemacs
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
b7a98cc788
doomemacs/modules/email/mu4e
History
Alexander Graul b7a98cc788 Add openSUSE prerequisite instructions 
These instructions were tested on openSUSE Tumbleweed and openSUSE Leap
15.1. There are some modules left that are not documented yet, but this
already improves the sitution for common openSUSE users.
2019-10-03 16:01:35 +02:00
..
autoload Conform many modules to new conventions 2019-07-23 12:30:47 +02:00
config.el 💥 Refactor add-hook! macro & change arg order 2019-07-26 20:17:29 +02:00
packages.el
README.org Add openSUSE prerequisite instructions 2019-10-03 16:01:35 +02:00

README.org

email/mu4e

Table of Contents   TOC

Description

This module makes Emacs an email client, using mu4e.

I want to live in Emacs, but as we all know, living is incomplete without email. So I prayed to the text editor gods and they (I) answered. Emacs+evil's editing combined with org-mode for writing emails? Yes please.

It uses mu4e to read my email, but depends on offlineimap (to sync my email via IMAP) and mu (to index my mail into a format mu4e can understand).

Module Flags

  • +gmail Enables gmail-specific configuration.

Plugins

Prerequisites

This module requires:

  • Either mbsync (default) or offlineimap (to sync mail with)
  • mu (to index your downloaded messages)

MacOS 

brew install mu --with-emacs
# And one of the following
brew install isync  # mbsync
brew install offlineimap

Arch Linux 

sudo pacman --noconfirm --needed -S mu
# And one of the following
sudo pacman -S isync  # mbsync
sudo pacman -S offlineimap

NixOS 

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

An example of setting up mbsync with home-manager

openSUSE

Remove # in #sync_program=offlineimap to choose offlineimap instead of mbsync.

sync_program=isync # mbsync
#sync_program=offlineimap
sudo zypper install maildir-utils $sync_programm

TODO Features

Configuration

offlineimap

This module uses mbsync by default. To change this, change +mu4e-backend:

(setq +mu4e-backend 'offlineimap)

Then you must set up offlineimap and index your mail:

  1. Write a \~/.offlineimaprc. 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.
  2. Download your email: offlineimap -o (may take a while)
  3. Index it with mu: mu index --maildir ~/.mail

Then configure Emacs to use your email address:

;; Each path is relative to `+mu4e-mu4e-mail-path', which is ~/.mail by default
(set-email-account! "Lissner.net"
  '((mu4e-sent-folder       . "/Lissner.net/Sent Mail")
    (mu4e-drafts-folder     . "/Lissner.net/Drafts")
    (mu4e-trash-folder      . "/Lissner.net/Trash")
    (mu4e-refile-folder     . "/Lissner.net/All Mail")
    (smtpmail-smtp-user     . "henrik@lissner.net")
    (user-mail-address      . "henrik@lissner.net")
    (mu4e-compose-signature . "---\nHenrik Lissner"))
  t)

TODO mbsync