Get this great stuff without effort:
- A full-featured and autoconfigured email client on the terminal with neomutt
- Mail stored offline enabling the ability to:
- view and write emails while you're away from the internet
- make backups
- Provides a
mailsync
script that can be scheduled to run as often as you like, which downloads/syncs mail and notifies you when new mail has arrived.
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 locally stores 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
- 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.
neomutt
- the email client. (If you are using Gentoo GNU/Linux, you will need thesasl
use flag to be enabled)curl
- tests connections (required at install).isync
- downloads and syncs the mail (required if storing IMAP mail locally).msmtp
- sends the email.pass
- safely encrypts passwords (required at install).
Note: There's a chance of errors if you use a slow-release distro like
Ubuntu, Debian, or Mint. If you get errors in neomutt
, install the most
recent version manually or manually remove the offending lines in the config in
/usr/share/mutt-wizard/mutt-wizard.muttrc
.
git clone https://github.com/LukeSmithxyz/mutt-wizard
cd mutt-wizard
sudo make install
A user of Arch-based distros can also install the current mutt-wizard release from the AUR as mutt-wizard, or the Github master branch, mutt-wizard-git.
pam-gnupg
- Automatically logs you into your GPG key on login so you will never need to input your password once logged on to your system. Check the repo and directions out here.lynx
- view HTML email in neomutt.notmuch
- index and search mail. Install it and runnotmuch setup
, tell it that your mail is in~/.local/share/mail/
(althoughmw
will do this automatically if you haven't set notmuch up before). You can run it in mutt withctrl-f
. Runnotmuch new
to process new mail.abook
- a terminal-based address book. Pressing tab while typing an address to send mail to will suggest contacts that are in your abook.urlview
- outputs urls in mail to browser.cronie
- (or any other major cronjob manager) to set up automatic mail syncing.mpop
- If you want to use POP protocol instead of IMAP.
The mutt-wizard runs via the command mw
. Once setup is complete, you'll use
neomutt
to access your mail.
mw -a [email protected]
-- add a new email accountmw -l
-- list existing accountsmw -y [email protected]
-- sync an email accountmw -Y
-- sync all configured email accountsmw -d
-- choose an account to deletemw -D [email protected]
-- delete account settings without confirmationmw -t 30
-- toggle automatic mailsync to every 30 minutesmw -T
-- toggle mailsync without specifying minutes (default is 10)mw -r
-- reorder account shortcut numberspass edit [email protected]
-- revise an account's password
-u
-- Give an account username if different from the email address.-n
-- A real name to be used by the account. Put in quotations if multiple words.-i
-- IMAP server address-I
-- IMAP server port (otherwise assumed to be 993)-s
-- SMTP server address-S
-- SMTP server port (otherwise assumed to be 465)-m
-- Maximum number of emails to be kept offline. No maximum is default functionality.-x
-- Account password. You will be prompted for it otherwise.
-p
-- Add a Protonmail account.-f
-- Assume mailbox names and force account configuration without connecting online at all.-o
-- Configure mutt for an account, but do not keep mail offline.-P
-- Use POP protocol instead of IMAP (requiresmpop
installed).
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 abook.?
- see all keyboard shortcutsctrl-j
/ctrl-k
- move up and down in sidebar,ctrl-o
opens mailbox.ctrl-b
- open a menu to select a URL you want to open in your browser.
pam-gnupg
- Automatically logs you into your GPG key on login, so you will never need to input your password once logged on to your system. Check the repo and directions out here.lynx
- View HTML email in neomutt.notmuch
- Index and search mail. Install it and runnotmuch setup
, tell it that your mail is in~/.local/share/mail/
(althoughmw
will do this automatically if you haven't set notmuch up before). You can run it in mutt withctrl-f
. Runnotmuch new
to process new mail.abook
- A terminal-based address book. Pressing tab while typing an address to send mail to will suggest contacts that are in your abook.urlview
- Outputs URLs in an email to your browser.
mw
is now scriptable with command-line options and can run successfully without any interaction, making it possible to deploy in a script.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 longer used 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. Fewer errors generally.
- Addition of a manual
man mw
- Now handles POP protocol via
mpop
for those who prefer it (add an account with the-P
option). POP configs are still generated automatically.
- 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 [email protected].
- 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 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 override this in yourmuttrc
if you wish.
- Gmail accounts need to create an App Password to use with "less secure" applications. This password is single-use (i.e. for setup) and will be stored and encrypted locally. Enabling third-party applications requires turning off two-factor authentication and this will circumvent that. You might also need to manually "Enable IMAP" in the settings.
- Protonmail accounts require a "Protonmail Bridge" to access PM's IMAP and SMTP servers. Configure that before running mutt-wizard. Note that when mutt-wizard asks for a password, you should put in your bridge password, not your account password.
- Protonmail bridge is prone to timing out. Watch out for this while adding an
account. If the bridge times out, try again. It might help to
increase the timeout
in your
mbsyncrc
. - 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.
isync
is not fully UTF-8 compatible, so non-Latin characters may be garbled (although sync should succeed).mw
will also not auto-create mailbox shortcuts since it is looking for English mailbox names. I strongly recommend you to set your email language to English on your mail server to avoid these problems.
mutt-wizard is free/libre software. This program is released under the GPLv3 license, which you can find in the file LICENSE.