aboutsummaryrefslogtreecommitdiff
path: root/content/blog/2024-04-18-mu4e.org
diff options
context:
space:
mode:
authorChristian Cleberg <hello@cleberg.net>2024-09-01 22:03:26 -0500
committerChristian Cleberg <hello@cleberg.net>2024-09-01 22:03:26 -0500
commita0578880ef14f54647d7cfd96382395ab1e3cddb (patch)
tree3b48908939708db6580a90d99bf88ff045311e9d /content/blog/2024-04-18-mu4e.org
parent17d0e7fa0f46eae4ef284af4593e33ad24da3bef (diff)
downloadcleberg.net-a0578880ef14f54647d7cfd96382395ab1e3cddb.tar.gz
cleberg.net-a0578880ef14f54647d7cfd96382395ab1e3cddb.tar.bz2
cleberg.net-a0578880ef14f54647d7cfd96382395ab1e3cddb.zip
format 2024 blog posts
Diffstat (limited to 'content/blog/2024-04-18-mu4e.org')
-rw-r--r--content/blog/2024-04-18-mu4e.org78
1 files changed, 36 insertions, 42 deletions
diff --git a/content/blog/2024-04-18-mu4e.org b/content/blog/2024-04-18-mu4e.org
index e422f88..dadfc0b 100644
--- a/content/blog/2024-04-18-mu4e.org
+++ b/content/blog/2024-04-18-mu4e.org
@@ -3,20 +3,18 @@
#+description:
#+slug: mu4e
-This post was heavily inspired by
-[[https://macowners.club/posts/email-emacs-mu4e-macos/][Email setup in
-Emacs with Mu4e on macOS]], but with my own tweaks for a single-account
-configuration and some Doom-specific configurations.
+This post was heavily inspired by [[https://macowners.club/posts/email-emacs-mu4e-macos/][Email setup in Emacs with Mu4e on macOS]], but
+with my own tweaks for a single-account configuration and some Doom-specific
+configurations.
* Overview
-[[https://github.com/emacsmirror/mu4e][Mu4e]] is an Emacs-based email
-client based on [[https://www.djcbsoftware.nl/code/mu/][mu]], an indexer
-that stores email in the Maildir format.
+[[https://github.com/emacsmirror/mu4e][Mu4e]] is an Emacs-based email client based on [[https://www.djcbsoftware.nl/code/mu/][mu]], an indexer that stores email in
+the Maildir format.
-This blog post covers the installation of Mu4e in Doom Emacs on macOS.
-This guide should be very similar to GNU Emacs and Linux-based systems,
-with a few tweaks required in the various configuration files.
+This blog post covers the installation of Mu4e in Doom Emacs on macOS. This
+guide should be very similar to GNU Emacs and Linux-based systems, with a few
+tweaks required in the various configuration files.
* Installation
@@ -34,21 +32,21 @@ mkdir ~/.maildir/certificates # used to store system root certificates
*** Store Email Account Passwords in macOS Keychain
-Next, I will be using the macOS Keychain to store my email account
-passwords using the command below.
+Next, I will be using the macOS Keychain to store my email account passwords
+using the command below.
#+begin_src sh
security add-generic-password -s mu4e-example -a you@example.com -w
#+end_src
This will prompt you to input your password twice to confirm. Keep the
-=mu4e-example= name in mind, as you will need to reference it later in
-the IMAP and SMTP configuration files.
+=mu4e-example= name in mind, as you will need to reference it later in the IMAP
+and SMTP configuration files.
*** Store Root Certificates
-In order to use IMAP and SMTP, we need to provide certificates to the
-local services. We will use the macOS defaults for this.
+In order to use IMAP and SMTP, we need to provide certificates to the local
+services. We will use the macOS defaults for this.
1. Open =Keychain Access.app=.
2. Select =System Roots= in the sidebar.
@@ -58,8 +56,8 @@ local services. We will use the macOS defaults for this.
*** Install Dependencies
-Install =mbsync= (via =isync=) to fetch emails via IMAP, =mu= to index
-emails, and =msmtp= to send emails via SMTP.
+Install =mbsync= (via =isync=) to fetch emails via IMAP, =mu= to index emails,
+and =msmtp= to send emails via SMTP.
#+begin_src sh
brew install mu isync msmtp
@@ -73,8 +71,8 @@ Within Doom Emacs, we can install Mu4e by enabling the package.
nano ~/.doom.d/init.el
#+end_src
-In this file, uncomment the =mu4e= line within the =:email= section. You
-can also enable the =+org= and =+gmail= options if you prefer.
+In this file, uncomment the =mu4e= line within the =:email= section. You can
+also enable the =+org= and =+gmail= options if you prefer.
#+begin_src lisp
(doom! :input
@@ -88,9 +86,9 @@ can also enable the =+org= and =+gmail= options if you prefer.
* Configuration
-As an overall suggestion, I create the following configuration files in
-the =~/.maildir= directory and using symlinks to their proper locations
-so that I can backup and restore these files easily.
+As an overall suggestion, I create the following configuration files in the
+=~/.maildir= directory and using symlinks to their proper locations so that I
+can backup and restore these files easily.
#+begin_src sh
touch ~/.maildir/.mbsyncrc && \
@@ -99,14 +97,13 @@ ln -s /Users/username/.maildir/.mbsyncrc /Users/username/.mbsyncrc && \
ln -s /Users/username/.maildir/.msmtprc /Users/username/.msmtprc
#+end_src
-You can also create these files in your home directory and skip the
-symlinking process above.
+You can also create these files in your home directory and skip the symlinking
+process above.
** IMAP
-Next, let's configure =mbsync= in the file created above. Paste the
-following information and customize it to match your mail provider's
-information.
+Next, let's configure =mbsync= in the file created above. Paste the following
+information and customize it to match your mail provider's information.
#+begin_src sh
nano ~/.maildir/.mbsyncrc
@@ -142,9 +139,8 @@ SyncState *
** SMTP
-Next, let's configured =msmtprc= in the file created above. Paste the
-following information and customize it to match your mail provider's
-information.
+Next, let's configured =msmtprc= in the file created above. Paste the following
+information and customize it to match your mail provider's information.
#+begin_src sh
nano ~/.maildir/.msmtprc
@@ -176,8 +172,8 @@ account default : startmail
** Doom Emacs
-Finally, we need to configure Doom Emacs to use the proper packages and
-set some variables and functions.
+Finally, we need to configure Doom Emacs to use the proper packages and set some
+variables and functions.
#+begin_src sh
nano ~/.doom.d/config.el
@@ -275,14 +271,12 @@ Be sure to sync Doom to update the current configurations.
doom sync
#+end_src
-If you have Doom open, execute =SPC h r r= to reload the new
-configurations.
+If you have Doom open, execute =SPC h r r= to reload the new configurations.
* Initial Sync
-Once you have configured all of the relevant files, you can perform an
-initial sync. Note that you can perform syncing within Mu4e itself after
-this.
+Once you have configured all of the relevant files, you can perform an initial
+sync. Note that you can perform syncing within Mu4e itself after this.
#+begin_src sh
mbsync -aV
@@ -299,11 +293,11 @@ The emails will now to be ready to use!
* Screenshots
-You can now launch Doom and open Mu4e with =SPC o m=. You can also
-explore the Mu4e options with =SPC : mu4e=.
+You can now launch Doom and open Mu4e with =SPC o m=. You can also explore the
+Mu4e options with =SPC : mu4e=.
-The home page shows various options and metadata about the account
-you've opened.
+The home page shows various options and metadata about the account you've
+opened.
#+caption: Mu4e Home Page
[[https://img.cleberg.net/blog/20240418-mu4e/mu4e.png]]