History

Henrik Lissner 77e4cc4d58 💥 Remove :feature category :feature was a "catch-all" category. Many of its modules fit better in other categories, so they've been moved: - feature/debugger -> tools/debugger - feature/evil -> editor/evil - feature/eval -> tools/eval - feature/lookup -> tools/lookup - feature/snippets -> editor/snippets - feature/file-templates -> editor/file-templates - feature/workspaces -> ui/workspaces More potential changes in the future: - A new :term category for terminal emulation modules (eshell, term and vterm). - A new :os category for modules dedicated to os-specific functionality. The :tools macos module would fit here, but so would modules for nixos and arch. - A new :services category for web-service integration, like wakatime, twitter, elfeed, gist and pastebin services.		2019-04-24 18:16:04 -04:00
..
autoload	💥 Remove :feature category	2019-04-24 18:16:04 -04:00
+gmail.el	email: move some gmail specific settings to gmail.el	2019-01-21 16:10:27 -08:00
config.el	feature/{syntax-checker,spellcheck} -> tools/fly{check,spell}	2019-02-22 00:25:30 -05:00
packages.el	app/email: redo mu4e->evil integration + improve marks for gmail support	2017-04-19 13:19:06 -04:00
README.org	app/email: rewrite README	2019-01-05 16:50:19 -05:00

README.org

app/email

Table of Contents
Description
- Module Flags
- Plugins
Prerequisites
- MacOS
- Arch Linux
Features
Configuration
- offlineimap
- mbsync

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

mu4e-maildirs-extension

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

TODO Features

Configuration

offlineimap

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

(setq +email-backend 'offlineimap)

Then you must set up offlineimap and index your mail:

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