{"id":6122,"date":"2017-04-06T12:17:00","date_gmt":"2017-04-06T16:17:00","guid":{"rendered":"http:\/\/irreal.org\/blog\/?p=6122"},"modified":"2017-04-06T12:17:07","modified_gmt":"2017-04-06T16:17:07","slug":"mu4e-configuration","status":"publish","type":"post","link":"https:\/\/irreal.org\/blog\/?p=6122","title":{"rendered":"Mu4e Configuration"},"content":{"rendered":"

This post is the latest in my series on installing and configuring mu4e<\/code> on a Mac and using Apple as a mail provider. As I wrote in my post on mbsync configuration<\/a>, setting up mu4e<\/code> is simple by comparison. On my MacBook Pro, I compiled the mu<\/code> package from source. On my iMac I installed it with homebrew. Either way works fine. The advantage of homebrew is that it will load all the libraries that you need but aren’t included in the base macOS install. <\/p>\n

My configuration is an adaption of Charl Botha’s<\/a>, which uses some of the features in the latest release, with the addition of some ideas from Ben Maughan<\/a> and a few bits of my own: <\/p>\n

\n
  1: <\/span>(require<\/span> 'mu4e<\/span>)\n  2: <\/span>\n  3: <\/span>;; <\/span>Call EWW to display HTML messages<\/span><\/span>\n  4: <\/span>(defun<\/span> jcs-view-in-eww<\/span> (msg)\n  5: <\/span>  (eww-browse-url (concat \"file:\/\/\"<\/span> (mu4e~write-body-to-html msg))))\n  6: <\/span>\n  7: <\/span>;; <\/span>Arrange to view messages in either the default browser or EWW<\/span>\n  8: <\/span>(add-to-list 'mu4e-view-actions '(\"ViewInBrowser\"<\/span> . mu4e-action-view-in-browser) t)\n  9: <\/span>(add-to-list 'mu4e-view-actions '(\"Eww view\"<\/span> . jcs-view-in-eww) t)<\/span>\n 10: <\/span>\n 11: <\/span>;; <\/span>From Ben Maughan: Get some Org functionality in compose buffer<\/span>\n 12: <\/span>(add-hook<\/span> 'message-mode-hook 'turn-on-orgtbl)\n 13: <\/span>(add-hook<\/span> 'message-mode-hook 'turn-on-orgstruct++)\n 14: <\/span>\n 15: <\/span>;; <\/span>Call mu every 5 minutes to update and index Maildir<\/span>\n 16: <\/span>(setq<\/span> mu4e-update-interval 300)\n 17: <\/span>\n 18: <\/span>;; <\/span>Set format=flowed<\/span>\n 19: <\/span>;; <\/span>mu4e sets up visual-line-mode and also fill (M-q) to do the right thing<\/span>\n 20: <\/span>;; <\/span>each paragraph is a single long line; at sending, emacs will add the<\/span>\n 21: <\/span>;; <\/span>special line continuation characters.<\/span>\n 22: <\/span>(setq<\/span> mu4e-compose-format-flowed t)\n 23: <\/span>\n 24: <\/span>;; <\/span>every new email composition gets its own frame! (window)<\/span>\n 25: <\/span>;;<\/span>(<\/span>setq<\/span> mu4e-compose-in-new-frame t)<\/span>\n 26: <\/span>\n 27: <\/span>;; <\/span>give me ISO(ish) format date-time stamps in the header list<\/span>\n 28: <\/span>(setq<\/span> mu4e-headers-date-format \"%Y-%m-%d %H:%M\"<\/span>)\n 29: <\/span>\n 30: <\/span>;; <\/span>show full addresses in view message (instead of just names)<\/span>\n 31: <\/span>;; <\/span>toggle per name with M-RET<\/span>\n 32: <\/span>(setq<\/span> mu4e-view-show-addresses 't)\n 33: <\/span>\n 34: <\/span>;;<\/span>store org-mode links to messages<\/span>\n 35: <\/span>(require<\/span> 'org-mu4e<\/span>)\n 36: <\/span>;;<\/span>store link to message if in header view, not to header query<\/span>\n 37: <\/span>(setq<\/span> org-mu4e-link-query-in-headers-mode nil)\n 38: <\/span>\n 39: <\/span>;;<\/span>rename files when moving<\/span>\n 40: <\/span>;;<\/span>NEEDED FOR MBSYNC<\/span>\n 41: <\/span>(setq<\/span> mu4e-change-filenames-when-moving t)\n 42: <\/span>\n 43: <\/span>;; <\/span>Try to show images<\/span>\n 44: <\/span>(setq<\/span> mu4e-view-show-images t\n 45: <\/span>      mu4e-show-images t\n 46: <\/span>      mu4e-view-image-max-width 800)\n 47: <\/span>\n 48: <\/span>;; <\/span>path to our Maildir directory<\/span>\n 49: <\/span>(setq<\/span> mu4e-maildir \"~\/Maildir\"<\/span>)\n 50: <\/span>\n 51: <\/span>;; <\/span>the next are relative to `<\/span>mu4e-maildir<\/span>'<\/span>\n 52: <\/span>;; <\/span>instead of strings, they can be functions too, see<\/span>\n 53: <\/span>;; <\/span>their docstring or the chapter 'Dynamic folders'<\/span>\n 54: <\/span>(setq<\/span> mu4e-sent-folder   \"\/icloud\/Sent Messages\"<\/span>\n 55: <\/span>      mu4e-drafts-folder \"\/icloud\/Drafts\"<\/span>\n 56: <\/span>      mu4e-trash-folder  \"\/icloud\/Trash\"<\/span>)\n 57: <\/span>\n 58: <\/span>;; <\/span>the maildirs you use frequently; access them with 'j' ('jump')<\/span>\n 59: <\/span>(setq<\/span>   mu4e-maildir-shortcuts\n 60: <\/span>        '((\"\/icloud\/Archive\"<\/span>             . ?a)\n 61: <\/span>          (\"\/icloud\/inbox\"<\/span>               . ?i)\n 62: <\/span>          (\"\/icloud\/Saved\"<\/span>               . ?v)\n 63: <\/span>          (\"\/icloud\/Sent Messages\"<\/span>       . ?s)))\n 64: <\/span>\n 65: <\/span>;; <\/span>the list of all of my e-mail addresses<\/span>\n 66: <\/span>(setq<\/span> mu4e-user-mail-address-list '(\"XXX@mac.com\"<\/span>\n 67: <\/span>                                    \"YYY@irreal.org\"<\/span>))\n 68: <\/span>\n 69: <\/span>;; <\/span>the headers to show in the headers list -- a pair of a field<\/span>\n 70: <\/span>;; <\/span>and its width, with `<\/span>nil<\/span>' meaning 'unlimited'<\/span>\n 71: <\/span>;; <\/span>(better only use that for the last field.<\/span>\n 72: <\/span>;; <\/span>These are the defaults:<\/span>\n 73: <\/span>(setq<\/span> mu4e-headers-fields\n 74: <\/span>    '( (:date<\/span>          .  25)    ;; <\/span>alternatively, use :human-date<\/span>\n 75: <\/span>       (:flags<\/span>         .   6)\n 76: <\/span>       (:from<\/span>          .  22)\n 77: <\/span>       (:subject<\/span>       .  nil))) ;; <\/span>alternatively, use :thread-subject<\/span>\n 78: <\/span>\n 79: <\/span>;; <\/span>Program to get mail.<\/span>\n 80: <\/span>;; <\/span>Called when 'U' is pressed in main view.<\/span>\n 81: <\/span>\n 82: <\/span>;; <\/span>If you get your mail without an explicit command,<\/span>\n 83: <\/span>;; <\/span>use \"true\" for the command (this is the default)<\/span>\n 84: <\/span>;; <\/span>when I press U in the main view, or C-c C-u elsewhere,<\/span>\n 85: <\/span>;; <\/span>this command is called, followed by the mu indexer<\/span>\n 86: <\/span>(setq<\/span> mu4e-get-mail-command \"mbsync icloud\"<\/span>)\n 87: <\/span>\n 88: <\/span>;; <\/span>not using smtp-async yet<\/span>\n 89: <\/span>;; <\/span>some of these variables will get overridden by the contexts<\/span>\n 90: <\/span>(setq<\/span>\n 91: <\/span> send-mail-function 'smtpmail-send-it\n 92: <\/span> message-send-mail-function 'smtpmail-send-it)\n 93: <\/span>\n 94: <\/span>;; <\/span>don't keep message buffers around<\/span>\n 95: <\/span>(setq<\/span> message-kill-buffer-on-exit t)\n 96: <\/span>\n 97: <\/span>;; <\/span>Contexts: One for each mail personality.<\/span><\/span>\n 98: <\/span>(setq<\/span> mu4e-contexts\n 99: <\/span>      `( ,(make-mu4e-context\n100: <\/span>           :name<\/span> \"a XXX@mac.com\"<\/span>\n101: <\/span>           :enter-func<\/span> (lambda<\/span> () (mu4e-message \"Enter XXX@mac.com context\"<\/span>))\n102: <\/span>           :leave-func<\/span> (lambda<\/span> () (mu4e-message \"Leave XXX@mac.com context\"<\/span>))\n103: <\/span>           ;; <\/span>Match based on the contact-fields of the message (that we are replying to)<\/span>\n104: <\/span>           :match-func<\/span> (lambda<\/span> (msg)\n105: <\/span>                         (when<\/span> msg \n106: <\/span>                           (mu4e-message-contact-field-matches msg \n107: <\/span>                                                               :to<\/span> \"XXX@mac.com\"<\/span>)))\n108: <\/span>           :vars<\/span> '( ( user-mail-address      . \"XXX@mac.com\"<\/span>  )\n109: <\/span>                    ( user-full-name         . \"Jon Snader\"<\/span> )\n110: <\/span>                    ( smtpmail-smtp-server   . \"smtp.mail.me.com\"<\/span> )\n111: <\/span>                    ( smtpmail-smtp-service  . 587)\n112: <\/span>                    ( smtpmail-stream-type   . starttls)))\n113: <\/span>\n114: <\/span>         ,(make-mu4e-context\n115: <\/span>           :name<\/span> \"i YYY@irreal.org\"<\/span>\n116: <\/span>           :enter-func<\/span> (lambda<\/span> () (mu4e-message \"Enter YYY@irreal.org context\"<\/span>))\n117: <\/span>           :leave-func<\/span> (lambda<\/span> () (mu4e-message \"Leave YYY@irreal.org context\"<\/span>))\n118: <\/span>           ;; <\/span>we match based on the contact-fields of the message<\/span>\n119: <\/span>           :match-func<\/span> (lambda<\/span> (msg)\n120: <\/span>                         (when<\/span> msg \n121: <\/span>                           (mu4e-message-contact-field-matches msg \n122: <\/span>                                                               :to<\/span> \"YYY@irreal.org\"<\/span>)))\n123: <\/span>           :vars<\/span> '( ( user-mail-address       . \"YYY@irreal.org\"<\/span> )\n124: <\/span>                    ( user-full-name          . \"Jon Snader\"<\/span> )\n125: <\/span>                    ( smtpmail-smtp-server    . \"smtp-server.tampabay.rr.com\"<\/span> )\n126: <\/span>                    ( smtpmail-stream-type    . plain)\n127: <\/span>                    ( smtpmail-smtp-service   . 25)))))\n128: <\/span>\n129: <\/span>\n130: <\/span>;; <\/span>start with the first (default) context; <\/span>\n131: <\/span>(setq<\/span> mu4e-context-policy 'pick-first)\n132: <\/span>\n133: <\/span>;; <\/span>compose with the current context if no context matches;<\/span>\n134: <\/span>(setq<\/span> mu4e-compose-context-policy nil)<\/span>\n135: <\/span>\n136: <\/span>(global-set-key (kbd \"C-<f6>\"<\/span>) 'mu4e)\n<\/pre>\n<\/div>\n
 As you can see, it’s very similar to Botha’s. Some emails, especially commercial ones (like those from Amazon) and those from professional groups like ACM, don’t render very well so I prefer to view them in a browser environment. Usually, EWW<\/code> is sufficient but sometimes I need the full Safari treatment. Lines 3<\/a>–9<\/a> show how to do that. If I press a<\/kbd> while viewing a message, it will bring up a menu with various viewing options. If I choose E<\/kbd> the message is displayed in EWW<\/code>. V<\/kbd> displays it in the default browser, Safari in my case. <\/p>\n
 The other noteworthy thing about the configuration are the contexts, which are configured on lines 97<\/a>–134<\/a>. All my emails are filtered through the Apple server so the contexts allow me to send mail either from my Apple account or my Irreal account. When I respond to an email, the correct “From:” address is chosen from the “To:” line of the original message. <\/p>\n
 Finally, there’s the matter of sending messages. Many writers recommend third party packages to handle multiple accounts but I’ve found the contexts in mu4e<\/code> handles that nicely. Unless you have special needs, like Ben Maughan<\/a>, using the built-in smtpmail<\/code> functionality is fine. You’ll want to set up an .authinfo<\/code> file to list the servers, accounts, and passwords. The line for the apple server looks like <\/p>\n
\nmachine smtp.mail.me.com login XXX@mac.com password same-password-as-for-mbsync\n<\/pre>\n
 You’ll want to encrypt the file for security, but Emacs only asks for the password one time per (Emacs) session so that’s not burdensome. <\/p>\n","protected":false},"excerpt":{"rendered":"
This post is the latest in my series on installing and configuring mu4e on a Mac and using Apple as a mail provider. As I wrote in my post on mbsync configuration, setting up mu4e is simple by comparison. On … Continue reading →<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[5],"tags":[18,166],"class_list":["post-6122","post","type-post","status-publish","format-standard","hentry","category-general","tag-emacs","tag-mu4e"],"_links":{"self":[{"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=\/wp\/v2\/posts\/6122","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=6122"}],"version-history":[{"count":1,"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=\/wp\/v2\/posts\/6122\/revisions"}],"predecessor-version":[{"id":6123,"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=\/wp\/v2\/posts\/6122\/revisions\/6123"}],"wp:attachment":[{"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=6122"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=6122"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=6122"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}