Luke Smith b759f255bc | 5 年前 | |
---|---|---|
bin | 5 年前 | |
share | 5 年前 | |
.gitignore | 5 年前 | |
LICENSE | 6 年前 | |
Makefile | 5 年前 | |
README.md | 5 年前 | |
mw.1 | 5 年前 |
Get this great stuff without effort:
Specifically, this wizard:
neomutt
, isync
, and msmtp
appropriate for your email addressgit 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.
NOTE: If you have used an older version of mutt-wizard, especially when it used to use offlineimap
, you need to remove your old configs. Back anything up that’s important and run:
rm -rf ~/.config/mutt ~/.msmtprc ~/.config/msmtp ~/.offlineimap ~/.offlineimaprc ~/.config/offlineimap ~/.mbsyncrc
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 mailneomutt
- the email client.isync
- downloads and syncs the mail. (required at install)msmtp
- sends the email.pass
- safely encrypts passwords (required at install)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
.
w3m
- view HTML email and images in neomutt.notmuch
- index and search mail. Install it and run notmuch setup
, tell it that your mail is in ~/.local/share/mail/
(although mw
will do this automatically if you haven’t set notmuch up before). You can run it in mutt with ctrl-f
. Run notmuch new
to process new mail, although the included mailsync
script does this for you.libnotify
/libnotify-bin
- allows notifications when syncthing mail with mailsync
abook
- a terminal-based address book. Pressing tab while typing an address to send mail to will suggest contacts that are in your abook.pam-gnupg
- this is a more general program that I use. It 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.urlview
- outputs urls in mail to browser.To give you an example of the interface, here’s an idea:
m
- send mail (uses your default $EDITOR
to write)j
/k
and d
/u
- vim-like bindings to go down and up (or d
/u
to go down/up a page).l
- open mail, or attachment page or attachmenth
- the opposite of l
r
/R
- reply/reply all to highlighted mails
- save selected mail or selected attachmentgs
,gi
,ga
,gd
,gS
- Press g
followed by another letter to change mailbox: s
ent, i
nbox, a
rchive, d
rafts, S
pam, etc.M
and C
- For M
ove and C
opy: follow them with one of the mailbox letters above, i.e. MS
means “move to Spam”.i#
- Press i
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 and Tab
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.ctrl-b
- open a menu to select a url you want to open in you browser.isync
/mbsync
has replaced offlineimap
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 (le bloat) and the interface is simply text commands.~/.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.man mw
domains.csv
so their users can more easily use mutt-wizard.See Luke’s website here. Email him at luke@lukesmith.xyz.
mutt-wizard is free/libre software, licensed under the GPLv3.
mutt
/neomutt
files are in ~/.config/mutt/
.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.accounts/
. You can edit these freely if you want to tinker with settings specific to an account./usr/share/mutt-wizard
are several global config files, including mutt-wizard
's default settings. You can overwride this in your muttrc
if you wish.isync
is not fully UTF-8 compatible, so non-Latin characters may be garbled (although sync should succeed). mw
will also not autocreate 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.