aboutsummaryrefslogtreecommitdiff
path: root/content/blog/2024-04-18-mu4e.md
diff options
context:
space:
mode:
authorChristian Cleberg <hello@cleberg.net>2024-04-29 14:18:55 -0500
committerChristian Cleberg <hello@cleberg.net>2024-04-29 14:18:55 -0500
commitfdd80eadcc2f147d0198d94b7b908764778184a2 (patch)
treefbec9522ea9aa13e8105efc413d2498c3c5b4cd6 /content/blog/2024-04-18-mu4e.md
parentd6c80fdc1dea9ff242a4d3c7d3939d2727a8da56 (diff)
downloadcleberg.net-fdd80eadcc2f147d0198d94b7b908764778184a2.tar.gz
cleberg.net-fdd80eadcc2f147d0198d94b7b908764778184a2.tar.bz2
cleberg.net-fdd80eadcc2f147d0198d94b7b908764778184a2.zip
format line wrapping and fix escaped characters
Diffstat (limited to 'content/blog/2024-04-18-mu4e.md')
-rw-r--r--content/blog/2024-04-18-mu4e.md99
1 files changed, 45 insertions, 54 deletions
diff --git a/content/blog/2024-04-18-mu4e.md b/content/blog/2024-04-18-mu4e.md
index 4c01731..c91cc65 100644
--- a/content/blog/2024-04-18-mu4e.md
+++ b/content/blog/2024-04-18-mu4e.md
@@ -6,19 +6,18 @@ draft = false
+++
This post was heavily inspired by [Email setup in Emacs with Mu4e on
-macOS](https://macowners.club/posts/email-emacs-mu4e-macos/), but with
-my own tweaks for a single-account configuration and some Doom-specific
-configurations.
+macOS](https://macowners.club/posts/email-emacs-mu4e-macos/), but with my own
+tweaks for a single-account configuration and some Doom-specific configurations.
# Overview
-[Mu4e](https://github.com/emacsmirror/mu4e) is an Emacs-based email
-client based on [mu](https://www.djcbsoftware.nl/code/mu/), an indexer
-that stores email in the Maildir format.
+[Mu4e](https://github.com/emacsmirror/mu4e) is an Emacs-based email client based
+on [mu](https://www.djcbsoftware.nl/code/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
@@ -36,33 +35,32 @@ 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.
```sh
security add-generic-password -s mu4e-example -a you@example.com -w
```
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.
-3. Select all items with `CMD + a`.
-4. Export selected items with `SHIFT + CMD + a` to the file
- `~/.maildir/certificates/root-certificates.pem`.
+1. Open `Keychain Access.app`.
+2. Select `System Roots` in the sidebar.
+3. Select all items with `CMD + a`.
+4. Export selected items with `SHIFT + CMD + a` to the file
+ `~/.maildir/certificates/root-certificates.pem`.
### 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.
```sh
brew install mu isync msmtp
@@ -76,9 +74,8 @@ Within Doom Emacs, we can install Mu4e by enabling the package.
nano ~/.doom.d/init.el
```
-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.
```lisp
(doom! :input
@@ -92,9 +89,9 @@ 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.
```sh
touch ~/.maildir/.mbsyncrc && \
@@ -103,14 +100,13 @@ ln -s /Users/username/.maildir/.mbsyncrc /Users/username/.mbsyncrc && \
ln -s /Users/username/.maildir/.msmtprc /Users/username/.msmtprc
```
-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.
```sh
nano ~/.maildir/.mbsyncrc
@@ -146,9 +142,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.
```sh
nano ~/.maildir/.msmtprc
@@ -180,8 +175,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.
```sh
nano ~/.doom.d/config.el
@@ -279,14 +274,12 @@ Be sure to sync Doom to update the current configurations.
doom sync
```
-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 afer
-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 afer this.
```sh
mbsync -aV
@@ -303,21 +296,19 @@ 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 metdata about the account
-you\'ve opened.
+The home page shows various options and metdata about the account you've
+opened.
![Mu4e Home Page](https://img.cleberg.net/blog/20240418-mu4e/mu4e.png)
-When composing an email, you can see the metadata fields at the top and
-compose the message below the indicator line.
+When composing an email, you can see the metadata fields at the top and compose
+the message below the indicator line.
-![Composition
-Screen](https://img.cleberg.net/blog/20240418-mu4e/draft.png)
+![Composition Screen](https://img.cleberg.net/blog/20240418-mu4e/draft.png)
-When in a folder, you can view emails in a pane and perform actions as
-needed.
+When in a folder, you can view emails in a pane and perform actions as needed.
![Inbox](https://img.cleberg.net/blog/20240418-mu4e/inbox.png)