Luke Smith 2063cda411 | 6年前 | |
---|---|---|
autoconf | 6年前 | |
credentials | 6年前 | |
etc | 6年前 | |
.gitignore | 6年前 | |
LICENSE.md | 6年前 | |
README.md | 6年前 | |
mutt-wizard.sh | 6年前 | |
muttrc | 6年前 |
Mutt is one of the most rewarding programs one can use, but can be a pain in the ass to configure. Since my job is making power-user tools available for the masses I want to create a tool that automates most of mutt configuration so that users can simply give their email address and get a /comfy/ setup. At that, I don’t just want a mutt wizard, but an offlineIMAP wizard, so users can easily access their mail offline as well, and a wizard that makes it easy to store passwords securely using gpg.
The mutt-wizard is all of this in a simple ncurses menu. It’s really just a little bash script, but one that can save countless people thousands of combined manhours of frustratingly trying to get all the moving pieces working together.
The system takes an email and autodetect its server settings, generating a muttrc and offlineimaprc profile automatically. If it can’t do so, it simply prompts you for these (which you can easily look up) and will put them all in the right places. You get:
i
prefix in mutt: i1
: first email account, i5
: fifth, etc.gi
: go to inbox, gs
to sent mail, ga
to archive, gS
to spam, gd
to drafts, etc.Yes! At this point, the only problems are the unexpected ones. Please try it, and if you do run into problems, email me at luke@lukesmith.xyz! I’ve tried the system personally on Gmail, Teknik.io, cock.li and Yandex, while others have tried other providers.
One email provider which I think will not work (and will never work) is Proton Mail, but that’s only because they require encryption through their web client IIRC.
Note also that Gmail and some providers require you to enable sign-ins from third-party (or as they call it “less secure”) applications to be able to load mail with mutt and offlineimap. Be sure to enable that!
dialog
, neomutt
and offlineimap
should be installed. You also need to have a GPG public/private key pair for the wizard to automatically store your passwords. The whole repo should be cloned to ~/.config/mutt/
. (If you have a previous mutt folder, you’ll want to back it up or delete it first.)
git clone https://github.com/LukeSmithxyz/mutt-wizard.git ~/.config/mutt
You will want to delete or rename your current ~/.offlineimaprc
as well, as although you can later modify the ~/.offlineimaprc
produced by the script, you must have no file there the first time you add your first account or the wizard will assume some settings are already set which aren’t.
Just run mutt-wizard.sh
and choose to add an account. After you do so, you may run offlineimap
to begin the mailsync, and you will be able to run neomutt and see your mail.
If mutt doesn’t immediately work properly run the Redetect mailboxes
option, then open mutt. This may be necessary for some accounts.
The automatically deployed configs will look for certain programs for certain extra abilities. Consider installing the following for the extra functionality.
urlview
-- Detecting and following links with ctrl-u
mupdf
-- for viewing attached pdfs (v
to view attachments, then select .pdf)notmuch
-- for mail searching and indexing set to ctrl-f
. Be sure to run notmuch setup
. Remember your mail is in ~/.mail/
when you configure notmuch.w3m
and/or w3mimg
-- for viewing images. Like .pdfs, view in the attachments menu.iproute2mac
for Mac users who want the autosync feature.mpv
if you want the autosync feature to notify you with a ding on new mail.Look at the code. The script takes the passwords you give it, encrypts them immediately with your own GPG key, and shreds the leftovers. Nothing malicious; it’s all there! If it makes you comfortable you can even run the script offline at first.
If you use mutt with a particular host or domain, put your server information in domains.csv
! This will make everyone else who uses your email provider’s life much easier!
Or you can help monetarily via Patreon or Paypal!
Mail is stored in ~/.mail
. mutt configs and caches for each account are in ~/.config/mutt/accounts/
. Encypted passwords are in ~/.config/mutt/credentials
. A “personal” muttrc, with the macros for switching accounts and the default config is in ~/.config/mutt/personal.muttrc
.
domains.csv
, possibly porting the Thunderbird autoconfigure settings.