diff options
author | Christian Cleberg <hello@cleberg.net> | 2024-04-29 14:18:55 -0500 |
---|---|---|
committer | Christian Cleberg <hello@cleberg.net> | 2024-04-29 14:18:55 -0500 |
commit | fdd80eadcc2f147d0198d94b7b908764778184a2 (patch) | |
tree | fbec9522ea9aa13e8105efc413d2498c3c5b4cd6 /content/blog/2024-04-18-mu4e.md | |
parent | d6c80fdc1dea9ff242a4d3c7d3939d2727a8da56 (diff) | |
download | cleberg.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.md | 99 |
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.  -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. - + -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.  |