mu-wizard

shell script to easily configure mu4e accounts on Emacs
git clone git://git.ckyln.com/~cem/mu-wizard
Log | Files | Refs | LICENSE

commit 6db886c040cf1a77575fba33de45025bc2580de1
parent c1dfc2256bd550547e47946bda9d568dd5a70408
Author: aaaawwWWWwwwwWWW <73749744+aaaawwWWWwwwwWWW@users.noreply.github.com>
Date:   Wed,  4 Nov 2020 14:39:42 -0300

Add 2 sections; overall improvements

- Separate the section "Installation and Configuration" in 2 sections: "Installation" and "Emacs Configuration". 
- Add further instructions for installation.
- Add "Usage" section in between. 
- Normalize markdown headings.
Diffstat:
MREADME.md | 41++++++++++++++++++++---------------------
1 file changed, 20 insertions(+), 21 deletions(-)

diff --git a/README.md b/README.md @@ -1,28 +1,35 @@ -mu-wizard --------------------------------------------------------------------------------- - +## mu-wizard Shell script to auto-configure email accounts for `mu4e` similar in function to mutt-wizard. It uses `isync` to synchronize mail accounts, `msmtp` to send mail and creates individual Lisp profiles for each account. It is still WIP. - -Dependencies --------------------------------------------------------------------------------- - +## Dependencies * `isync` (for offline mail storage) * `mu` (or maildir-utils depending on your distribution) * `msmtp` (for sending mails) * Password manager (`pass`, `pash`, and `pm` is supported) +## Installation +In order to install mu-wizard, clone this repository and build mu-wizard. + git clone https://github.com/cemkeylan/mu-wizard.git + cd mu-wizard + make install -Installation and Configuration --------------------------------------------------------------------------------- +Users of Arch Linux based distributions can install mu-wizard through the AUR package [mu-wizard-git](https://aur.archlinux.org/packages/mu-wizard-git/): -In order to install clone this repository and run the following command. + yay -S mu-wizard-git - make install +## Usage +The wizard is run with `muw`. The options bellow are availabe for usage with `muw`: +- `muw`: Show usage help. +- `muw a`: **Add** and aoutoconfigure an email address. +- `muw d`: Pick an account to **delete**. +- `muw l`: **List** configured accounts. +- `muw p`: **Purge** all configuration. +- `muw s`: See your **share** directory: command not found. +## Emacs Configuration Emacs will not be loading the configurations, you will need to set it manually. In your init file, you may choose to load the configuration in the following ways. @@ -42,28 +49,20 @@ ways. :load-path "~/.config/mu4e") ``` - -`Domains.csv` file --------------------------------------------------------------------------------- - +## `Domains.csv` file `mu-wizard` doesn't come with a predefined `domains.csv` file, but it can use one if it is found on `/usr/share/mu-wizard/domains.csv`. `mu-wizard` also saves the domain information that you use when creating an account on your configuration directory, so you don't have to retype every detail when creating a second account with the same domain. - -Overrides --------------------------------------------------------------------------------- - +## Overrides Domain-level overrides are possible by adding a shell file to either the share directory (`/usr/local/share/mu-wizard/overrides`) or the user configuration directory (`~/.config/mu4e/overrides`). See `overrides/protonmail.com` for an example override. You can run `muw share` to learn your share directory. - ### Protonmail users - `mu-wizard` supports protonmail. If you are using one of the default domains, you don't have to do anything. If you are an alternative domain, you can link the protonmail.com override to your personal domain. Here is an example: