2015-12-02 14:23:39 +00:00
|
|
|
|
#+TITLE: Mu4e layer
|
2016-03-31 02:59:55 +00:00
|
|
|
|
|
|
|
|
|
* Table of Contents :TOC_4_gh:noexport:
|
2017-05-22 14:16:12 +00:00
|
|
|
|
- [[#install][Install]]
|
|
|
|
|
- [[#commands][Commands]]
|
|
|
|
|
- [[#global-bindings][Global bindings]]
|
|
|
|
|
- [[#headers-mode][Headers mode]]
|
|
|
|
|
- [[#view-mode][View mode]]
|
|
|
|
|
- [[#configuration][Configuration]]
|
|
|
|
|
- [[#maildirs-extension][Maildirs extension]]
|
|
|
|
|
- [[#multiple-accounts][Multiple Accounts]]
|
|
|
|
|
- [[#example-configuration][Example configuration]]
|
|
|
|
|
- [[#notifications][Notifications]]
|
|
|
|
|
- [[#os-notifications][OS notifications]]
|
|
|
|
|
- [[#mode-line-notifications][Mode-line notifications]]
|
|
|
|
|
- [[#spacemacs-layout-integration][Spacemacs layout integration]]
|
|
|
|
|
- [[#see-also][See also]]
|
2015-08-02 05:30:30 +00:00
|
|
|
|
|
2016-01-06 05:21:55 +00:00
|
|
|
|
* Install
|
2015-11-11 20:45:30 +00:00
|
|
|
|
In order to use this layer you must install mu and mu4e separately. Typically
|
|
|
|
|
mu4e will be bundled with mu (this is the case on many Linux distributions).
|
2015-08-02 05:30:30 +00:00
|
|
|
|
|
2016-07-25 17:46:24 +00:00
|
|
|
|
If you're on OS X and install mu using Homebrew, you must specify the
|
|
|
|
|
location of your Emacs binary at install time using the EMACS environment
|
2016-11-21 15:57:14 +00:00
|
|
|
|
variable, as well as passing the =--with-emacs= option:
|
2016-07-25 17:46:24 +00:00
|
|
|
|
|
|
|
|
|
#+begin_src shell
|
|
|
|
|
brew install mu --with-emacs
|
|
|
|
|
#+end_src
|
|
|
|
|
|
2015-11-11 20:45:30 +00:00
|
|
|
|
If the installation directory of mu4e is not in Emacs’ load path, you can set
|
|
|
|
|
the layer variable =mu4e-installation-path=, for example:
|
2015-08-02 05:30:30 +00:00
|
|
|
|
|
2015-11-11 20:45:30 +00:00
|
|
|
|
#+begin_src emacs-lisp
|
|
|
|
|
(setq-default dotspacemacs-configuration-layers
|
|
|
|
|
'((mu4e :variables
|
|
|
|
|
mu4e-installation-path "/usr/share/emacs/site-lisp")))
|
|
|
|
|
#+end_src
|
|
|
|
|
|
2016-01-08 20:13:02 +00:00
|
|
|
|
Then add this layer to your =~/.spacemacs=. You will need to add =mu4e= to the
|
|
|
|
|
existing =dotspacemacs-configuration-layers= list in this file.
|
2016-01-06 05:21:55 +00:00
|
|
|
|
|
2015-11-11 20:45:30 +00:00
|
|
|
|
* Commands
|
2015-11-23 06:55:56 +00:00
|
|
|
|
** Global bindings
|
|
|
|
|
|
2015-08-02 05:30:30 +00:00
|
|
|
|
| Keybinding | Command |
|
|
|
|
|
|------------+------------|
|
2016-11-23 16:23:40 +00:00
|
|
|
|
| ~SPC a M~ | Start mu4e |
|
2015-08-02 05:30:30 +00:00
|
|
|
|
|
2015-11-23 06:55:56 +00:00
|
|
|
|
** Headers mode
|
|
|
|
|
|
|
|
|
|
| Keybinding | Command |
|
|
|
|
|
|------------+-------------------------------------------------------------|
|
2016-11-23 16:23:40 +00:00
|
|
|
|
| ~J~ | Go to next unread thread marking other mail read on the way |
|
|
|
|
|
| ~C-j~ | Next header |
|
|
|
|
|
| ~C-k~ | Previous header |
|
2015-11-23 06:55:56 +00:00
|
|
|
|
|
|
|
|
|
** View mode
|
|
|
|
|
|
|
|
|
|
| Keybinding | Command |
|
|
|
|
|
|------------+-------------------------------------------------------------|
|
2016-11-23 16:23:40 +00:00
|
|
|
|
| ~J~ | Go to next unread thread marking other mail read on the way |
|
|
|
|
|
| ~C-j~ | Next header |
|
|
|
|
|
| ~C-k~ | Previous header |
|
2015-11-23 06:55:56 +00:00
|
|
|
|
|
2015-11-11 20:45:30 +00:00
|
|
|
|
* Configuration
|
2015-08-02 05:30:30 +00:00
|
|
|
|
Configuration varies too much to give precise instructions. What follows is one
|
|
|
|
|
example configuration. Refer to mu4e's manual for more detailed configuration
|
|
|
|
|
instructions.
|
|
|
|
|
|
2016-01-05 17:45:57 +00:00
|
|
|
|
** Maildirs extension
|
|
|
|
|
The maildirs extension adds a list of all your maildirs to the main mu4e view
|
|
|
|
|
that by default shows the unread and total mail counts for all your mail under
|
|
|
|
|
your base mail directory.
|
|
|
|
|
|
2016-01-09 03:33:26 +00:00
|
|
|
|
This extension is enabled by default, you can deactivate (and uninstall) it by
|
2017-06-10 19:22:34 +00:00
|
|
|
|
adding the package =mu4e-maildirs-extension= to your dotfile variable
|
|
|
|
|
=dotspacemacs-excluded-packages=.
|
2016-01-05 17:45:57 +00:00
|
|
|
|
|
2015-11-13 09:03:25 +00:00
|
|
|
|
** Multiple Accounts
|
2016-01-27 05:05:35 +00:00
|
|
|
|
With `mu 0.9.16`, mu4e comes with a native contexts feature for managing
|
|
|
|
|
multiple accounts.
|
2015-08-02 05:30:30 +00:00
|
|
|
|
|
2016-01-27 05:05:35 +00:00
|
|
|
|
The following example is taken from the manual:
|
2016-01-19 16:06:34 +00:00
|
|
|
|
|
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
2016-01-27 05:05:35 +00:00
|
|
|
|
(setq mu4e-contexts
|
|
|
|
|
`( ,(make-mu4e-context
|
|
|
|
|
:name "Private"
|
|
|
|
|
:enter-func (lambda () (mu4e-message "Switch to the Private context"))
|
|
|
|
|
;; leave-func not defined
|
|
|
|
|
:match-func (lambda (msg)
|
|
|
|
|
(when msg
|
|
|
|
|
(mu4e-message-contact-field-matches msg
|
|
|
|
|
:to "aliced@home.example.com")))
|
|
|
|
|
:vars '( ( user-mail-address . "aliced@home.example.com" )
|
|
|
|
|
( user-full-name . "Alice Derleth" )
|
|
|
|
|
( mu4e-compose-signature .
|
|
|
|
|
(concat
|
|
|
|
|
"Alice Derleth\n"
|
|
|
|
|
"Lauttasaari, Finland\n"))))
|
|
|
|
|
,(make-mu4e-context
|
|
|
|
|
:name "Work"
|
|
|
|
|
:enter-func (lambda () (mu4e-message "Switch to the Work context"))
|
|
|
|
|
;; leave-fun not defined
|
|
|
|
|
:match-func (lambda (msg)
|
|
|
|
|
(when msg
|
|
|
|
|
(mu4e-message-contact-field-matches msg
|
|
|
|
|
:to "aderleth@miskatonic.example.com")))
|
|
|
|
|
:vars '( ( user-mail-address . "aderleth@miskatonic.example.com" )
|
|
|
|
|
( user-full-name . "Alice Derleth" )
|
|
|
|
|
( mu4e-compose-signature .
|
|
|
|
|
(concat
|
|
|
|
|
"Prof. Alice Derleth\n"
|
|
|
|
|
"Miskatonic University, Dept. of Occult Sciences\n"))))))
|
|
|
|
|
|
|
|
|
|
;; set `mu4e-context-policy` and `mu4e-compose-policy` to tweak when mu4e should
|
|
|
|
|
;; guess or ask the correct context, e.g.
|
|
|
|
|
|
|
|
|
|
;; start with the first (default) context;
|
|
|
|
|
;; default is to ask-if-none (ask when there's no context yet, and none match)
|
|
|
|
|
;; (setq mu4e-context-policy 'pick-first)
|
|
|
|
|
|
|
|
|
|
;; compose with the current context is no context matches;
|
|
|
|
|
;; default is to ask
|
|
|
|
|
;; '(setq mu4e-compose-context-policy nil)
|
2016-01-19 16:06:34 +00:00
|
|
|
|
#+END_SRC
|
|
|
|
|
|
2016-01-27 05:05:35 +00:00
|
|
|
|
Note: We used to have a hack to support multiple accounts with older version of
|
|
|
|
|
`mu` but we removed it to encourage people to update their version and use the
|
|
|
|
|
new contexts feature.
|
2016-01-31 08:20:05 +00:00
|
|
|
|
|
2015-11-11 20:45:30 +00:00
|
|
|
|
** Example configuration
|
2015-08-02 05:30:30 +00:00
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
|
|
|
;;; Set up some common mu4e variables
|
|
|
|
|
(setq mu4e-maildir "~/.mail"
|
|
|
|
|
mu4e-trash-folder "/Trash"
|
|
|
|
|
mu4e-refile-folder "/Archive"
|
|
|
|
|
mu4e-get-mail-command "mbsync -a"
|
|
|
|
|
mu4e-update-interval nil
|
|
|
|
|
mu4e-compose-signature-auto-include nil
|
|
|
|
|
mu4e-view-show-images t
|
|
|
|
|
mu4e-view-show-addresses t)
|
|
|
|
|
|
|
|
|
|
;;; Mail directory shortcuts
|
|
|
|
|
(setq mu4e-maildir-shortcuts
|
|
|
|
|
'(("/gmail/INBOX" . ?g)
|
|
|
|
|
("/college/INBOX" . ?c)))
|
|
|
|
|
|
|
|
|
|
;;; Bookmarks
|
|
|
|
|
(setq mu4e-bookmarks
|
|
|
|
|
`(("flag:unread AND NOT flag:trashed" "Unread messages" ?u)
|
|
|
|
|
("date:today..now" "Today's messages" ?t)
|
|
|
|
|
("date:7d..now" "Last 7 days" ?w)
|
|
|
|
|
("mime:image/*" "Messages with images" ?p)
|
|
|
|
|
(,(mapconcat 'identity
|
|
|
|
|
(mapcar
|
|
|
|
|
(lambda (maildir)
|
|
|
|
|
(concat "maildir:" (car maildir)))
|
|
|
|
|
mu4e-maildir-shortcuts) " OR ")
|
|
|
|
|
"All inboxes" ?i)))
|
|
|
|
|
#+END_SRC
|
|
|
|
|
|
2016-01-30 01:56:33 +00:00
|
|
|
|
** Notifications
|
2016-11-22 20:53:50 +00:00
|
|
|
|
=mu4e-alert= is an extension that provides desktop notifications and adds the
|
2016-01-30 01:56:33 +00:00
|
|
|
|
count of unread messages to the modeline.
|
|
|
|
|
|
|
|
|
|
[[https://raw.githubusercontent.com/iqbalansari/mu4e-alert/master/screenshots/mu4e-alert-in-action.png]]
|
|
|
|
|
|
2016-02-14 16:20:14 +00:00
|
|
|
|
For an extended documentation of the available customizations please refer to
|
2017-04-26 13:50:19 +00:00
|
|
|
|
[[https://github.com/iqbalansari/mu4e-alert#user-content-customizations][mu4e-alert's documentation]]
|
2016-02-14 16:20:14 +00:00
|
|
|
|
|
|
|
|
|
*** OS notifications
|
2016-01-30 01:56:33 +00:00
|
|
|
|
To enable notifications about new messages, add the following line to your
|
2016-11-22 20:53:50 +00:00
|
|
|
|
=dotspacemacs/user-config=:
|
2016-01-30 01:56:33 +00:00
|
|
|
|
|
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
|
|
|
(setq mu4e-enable-notifications t)
|
|
|
|
|
#+END_SRC
|
|
|
|
|
|
2016-02-14 16:20:14 +00:00
|
|
|
|
or use layer variables when you add the layer to
|
|
|
|
|
=dotspacemacs-configuration-layers=:
|
|
|
|
|
|
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
|
|
|
(mu4e :variables mu4e-enable-notifications t)
|
|
|
|
|
#+END_SRC
|
|
|
|
|
|
2016-11-22 20:53:50 +00:00
|
|
|
|
By default, notifications will be shown in the =*Messages*= buffer. To enable
|
2016-01-30 01:56:33 +00:00
|
|
|
|
desktop notifications about new messages, add the following lines to
|
2016-11-22 20:53:50 +00:00
|
|
|
|
your =dotspacemacs/user-config=, according to your operating system and the
|
2016-01-30 01:56:33 +00:00
|
|
|
|
installed libraries:
|
|
|
|
|
|
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
|
|
|
(with-eval-after-load 'mu4e-alert
|
|
|
|
|
;; Enable Desktop notifications
|
|
|
|
|
(mu4e-alert-set-default-style 'notifications)) ; For linux
|
|
|
|
|
;; (mu4e-alert-set-default-style 'libnotify)) ; Alternative for linux
|
|
|
|
|
;; (mu4e-alert-set-default-style 'notifier)) ; For Mac OSX (through the
|
|
|
|
|
; terminal notifier app)
|
|
|
|
|
;; (mu4e-alert-set-default-style 'growl)) ; Alternative for Mac OSX
|
|
|
|
|
#+END_SRC
|
|
|
|
|
|
2016-02-14 16:20:14 +00:00
|
|
|
|
*** Mode-line notifications
|
|
|
|
|
To enable mode-line display about new messages, add the following line to
|
2016-11-22 20:53:50 +00:00
|
|
|
|
your =dotspacemacs/user-config=:
|
2016-01-30 01:56:33 +00:00
|
|
|
|
|
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
|
|
|
(setq mu4e-enable-mode-line t)
|
|
|
|
|
#+END_SRC
|
|
|
|
|
|
2016-02-14 16:20:14 +00:00
|
|
|
|
or use layer variables when you add the layer to
|
|
|
|
|
=dotspacemacs-configuration-layers=:
|
|
|
|
|
|
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
|
|
|
(mu4e :variables mu4e-enable-mode-line t)
|
|
|
|
|
#+END_SRC
|
2016-01-30 01:56:33 +00:00
|
|
|
|
|
2017-05-11 16:03:52 +00:00
|
|
|
|
** Spacemacs layout integration
|
|
|
|
|
A [[file:../../../doc/DOCUMENTATION.org::#layouts-and-workspaces][Spacemacs custom layout]] is defined by the layer. The name and the key binding
|
|
|
|
|
for it can be customized with the following layer variables:
|
|
|
|
|
- =mu4e-spacemacs-layout-name= for the layout name,
|
|
|
|
|
- =mu4e-spacemacs-layout-binding= for the key binding.
|
|
|
|
|
|
|
|
|
|
By default the values are:
|
|
|
|
|
|
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
|
|
|
(setq-default dotspacemacs-configuration-layers '(
|
|
|
|
|
(mu4e :variables mu4e-spacemacs-layout-name "@Mu4e"
|
|
|
|
|
mu4e-spacemacs-layout-binding "m")))
|
|
|
|
|
#+END_SRC
|
|
|
|
|
|
2015-11-11 20:45:30 +00:00
|
|
|
|
* See also
|
2015-08-02 05:30:30 +00:00
|
|
|
|
Refer to the official mu and mu4e documentation for additional info.
|
|
|
|
|
|
|
|
|
|
- [[http://www.djcbsoftware.nl/code/mu/mu4e/index.html][mu4e Manual]]
|