Get this great stuff without effort:
- A full-featured and autoconfigured email client on the terminal with neomutt
- Mail stored offline so you can view and write email while away from internet and keep backups
Specifically, this wizard:
- Determines your email server's IMAP and SMTP servers and ports
- Creates dotfiles for
neomutt
,isync
, andmsmtp
appropriate for your email address - Encrypts and stores locally your password for easy remote access, accessible only by your GPG key
- Handles as many as nine separate email accounts automatically
- Auto-creates bindings to switch between accounts or between mailboxes
- Can automatically set mail updates as often as you want to sync your mail and update you when new mail arrives
- Provides sensible defaults and an attractive appearance for the neomutt email client
- If mutt-wizard doesn't know your server's IMAP/SMTP info by default, it will prompt you for them and will put them in all the right places.
git clone https://github.com/LukeSmithxyz/mutt-wizard
cd mutt-wizard
sudo make install
User of Arch-based distros can also install mutt-wizard from the AUR as mutt-wizard-git.
The mutt-wizard is run with the command mw
. It also installs the mailsync
command. Once everything is setup, you'll use neomutt
to access your mail.
mw add
-- add a new email accountmw ls
-- list existing accountsmw pass
-- revise an account's passwordmw delete
-- deleted an added accountmw purge
-- delete all accounts and settingsmw cron
-- toggle/configure a cronjob to sync mail
neomutt
- the email client.isync
- downloads and syncs the mail. (required at install)msmtp
- sends the email.pass
- safely encrypts passwords (required at install)
w3m
- view HTML email and images in neomutt.notmuch
- index and search mail. Install it and runnotmuch setup
, tell it that your mail is in~/.local/share/mail/
. You can run it in mutt withctrl-f
. Runnotmuch new
to process new mail, although the includedmailsync
script does this for you.abook
- a terminal-based address book. Pressing tab while typing an address to send mail to will suggest contacts that are in your abook.- A cron manager - if you want to enable the auto-sync feature.
To give you an example of the interface, here's an idea:
m
- send mail (uses your default$EDITOR
to write)j
/k
andd
/u
- vim-like bindings to go down and up (ord
/u
to go down/up a page).l
- open mail, or attachment page or attachmenth
- the opposite ofl
r
/R
- reply/reply all to highlighted mails
- save selected mail or selected attachmentgs
,gi
,ga
,gd
,gS
- Pressg
followed by another letter to change mailbox:s
ent,i
nbox,a
rchive,d
rafts,S
pam, etc.M
andC
- ForM
ove andC
opy: follow them with one of the mailbox letters above, i.e.MS
means "move to Spam".i#
- Pressi
followed by a number 1-9 to go to a different account. If you add 9 accounts via mutt-wizard, they will each be assigned a number.a
to add address/person to abook andTab
while typing address to complete one from book.?
- see all keyboard shortcutsctrl-j
/ctrl-k
- move up and down in sidebar,ctrl-o
opens mailbox
isync
/mbsync
has replacedofflineimap
as the backend. Offlineimap was error-prone, bloated, used obsolete Python 2 modules and required separate steps to install the system.mw
is now an installed program instead of just a script needed to be kept in your mutt folder.dialog
is no long used (le bloat) and the interface is simply text commands.- More autogenerated shortcuts that allow quickly moving and copying mail between boxes.
- More elegant attachment handling. Image/video/pdf attachments without relying on the neomutt instance.
- abook integration by default.
- The messy template files and other directories have been moved or removed, leaving a clean config folder.
- msmtp configs moved to
~/.config/
and mail default location moved to~/.local/share/mail/
, reducing mess in~
. pass
is used as a password manager instead of separately saving passwords.- Script is POSIX sh compliant.
- Error handling for the many people who don't read or follow directions. Less errors generally.
- Addition of a manual
man mw
- Try mutt-wizard out on weird machines and weird email addresses and report any errors.
- Open a PR to add new server information into
domains.csv
so their users can more easily use mutt-wizard. - If nothing else, Donate!
See Luke's website here. Email him at luke@lukesmith.xyz.
mutt-wizard is free/libre software, licensed under the GPLv3.
- The critical
mutt
/neomutt
files are in~/.config/mutt/
. - Put whatever global settings you want in
muttrc
. mutt-wizard will add some lines to this file which you shouldn't remove unless you know what you're doing, but you can move them up/down over your personal config lines if you need to. If you get binding conflict errors in mutt, you might need to do this. - Each of the accounts that mutt-wizard generates will have custom settings set in a separate file in
accounts/
. You can edit these freely if you want to tinker with settings specific to an account. - In
/usr/share/mutt-wizard
are several global config files, includingmutt-wizard
's default settings. You can overwride this in yourmuttrc
if you wish.
- For Gmail accounts, remember also to enable third-party ("""less secure""") applications before attempting installation.
- Protonmail accounts will require you to set up "Protonmail Bridge" to access PM's IMAP and SMTP servers. Configure that before running mutt-wizard.
- If you have a university email, or enterprise-hosted email for work, there might be other hurdles or two-factor authentication you have to jump through. Some, for example, will want you to create a separate IMAP password, etc.
- If you use an email server whose mailboxes are not in English, mutt-wizard might not be able to guess which is which, so you may have to manually set your Inbox, Sent, Trash, Drafts, etc. in your mutt config file. Do this after running the wizard in
accounts/NAME.muttrc
.