mu-wizard

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

commit 0d310c629726d471434c124895139f85ddd6e9bf
parent c80d9871818cb2d88c404bd6e611b85a12289192
Author: Cem Keylan <cem@ckyln.com>
Date:   Thu,  5 Nov 2020 10:13:58 +0300

README: fix style

Diffstat:
MREADME.md | 56+++++++++++++++++++++++++++++++++++++++++---------------
1 file changed, 41 insertions(+), 15 deletions(-)

diff --git a/README.md b/README.md @@ -1,35 +1,51 @@ -## 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 + +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 -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/): +Users of Arch Linux based distributions can install mu-wizard through the AUR +package [mu-wizard-git] yay -S mu-wizard-git -## 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. -## Emacs Configuration +Usage +-------------------------------------------------------------------------------- + +The wizard is called by running `muw`. The options below are available for usage +with it. + + muw a: Add and autoconfigure 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 + + +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. @@ -49,20 +65,28 @@ 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: @@ -70,3 +94,5 @@ the protonmail.com override to your personal domain. Here is an example: ``` sh ln -sf /usr/share/mu-wizard/overrides/protonmail.com $HOME/.config/mu4e/overrides/example.com ``` + +[mu-wizard-git]: https://aur.archlinux.org/packages/mu-wizard-git/