History

Henrik Lissner f6dc6ac74e Refactor out map.el usage After some profiling, it turns out map-put and map-delete are 5-7x slower (more on Emacs 25) than delq, setf/alist-get and add-to-list for small lists (under 250 items), which is exactly how I've been using them. The only caveat is alist-get's signature is different on Emacs 25, thus a polyfill is necessary in core-lib.		2018-06-23 19:53:54 +02:00
..
autoload	General, minor refactor & revision	2018-06-16 12:26:58 +02:00
+gmail.el	Refactor out map.el usage	2018-06-23 19:53:54 +02:00
config.el	Replace :email with set-email-account! autodef	2018-06-15 18:03:50 +02:00
packages.el	app/email: redo mu4e->evil integration + improve marks for gmail support	2017-04-19 13:19:06 -04:00
README.org	Standardize module READMEs	2017-08-21 20:13:31 +02:00

README.org

:app email

Table of Contents
Install
- MacOS
- Arch Linux
Dependencies

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).

WARNING: my config is gmail/gsuite oriented, and since Google has its own opinions on the IMAP standard, it is unlikely to translate to other hosts.

Install

This module requires:

offlineimap (to sync mail with)
mu (to index your downloaded messages)

MacOS

brew install mu --with-emacs
brew install offlineimap

Arch Linux

sudo pacman --noconfirm --needed -S offlineimap mu

Dependencies

You need to do the following:

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

Then configure Emacs to use your email address:

;; Each path is relative to `+email-mu4e-mail-path', which is ~/.mail by default
(set! :email "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)