| @@ -0,0 +1,3 @@ | |||
| github: lukesmithxyz | |||
| custom: ["https://lukesmith.xyz/donate", "https://paypal.me/lukemsmith", "https://lukesmith.xyz/crypto"] | |||
| patreon: lukesmith | |||
| @@ -3,13 +3,13 @@ | |||
| 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 | |||
| - Mail stored offline so you can view and write email while you're 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`, and `msmtp` appropriate for your email address | |||
| - Encrypts and stores locally your password for easy remote access, accessible only by your GPG key | |||
| - 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 | |||
| - Can automatically set mail updates as often as you want to sync your mail and update you when new mail arrives | |||
| @@ -48,7 +48,7 @@ There's a chance of errors if you use a slow-release distro like Ubuntu, Debian | |||
| - `lynx` - view HTML email 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` | |||
| - `libnotify`/`libnotify-bin` - allows notifications when syncing 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. | |||
| - A cron manager - if you want to enable the auto-sync feature. | |||
| - `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](https://github.com/cruegge/pam-gnupg). | |||
| @@ -105,12 +105,12 @@ mutt-wizard is free/libre software, licensed under the GPLv3. | |||
| ## Watch out for these things: | |||
| - Gmail accounts can now create 'App Password' to use with """less secure""" applications. This password is single use (ie. 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 will require you to set up "Protonmail Bridge" to access PM's IMAP and SMTP servers. Configure that before running mutt-wizard. | |||
| - Protonmail bridge is prone to timing out. Watch out for this while adding an account. If the bridge times out, try again. | |||
| - Protonmail accounts will require you to set up "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](https://protonmail.com/bridge/thunderbird#3), 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](https://protonmail.com/support/knowledge-base/thunderbird-connection-server-timed-error/) 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 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. | |||
| ## To-do | |||
| - Add ~~Mac OS~~/BSD compatibility (the script is confired to work for Mac OS now) | |||
| - Add ~~Mac OS~~/~~BSD~~ compatibility (the script is confirmed to work for Mac OS and FreeBSD now) | |||
| - ~~Out-of-the-box compatibility with Protonmail Bridge~~ (I believe this is done, but more bug-testing is welcome since I don't have PM) | |||
| @@ -12,24 +12,25 @@ ping -q -c 1 1.1.1.1 > /dev/null || { echo "No internet connection detected."; e | |||
| command -v notify-send >/dev/null || echo "Note that \`libnotify\` or \`libnotify-send\` should be installed for pop-up mail notifications with this script." | |||
| # Required to display notifications if run as a cronjob: | |||
| DBUS_SESSION_BUS_ADDRESS=unix:path=/run/user/$(id -u)/bus | |||
| export DBUS_SESSION_BUS_ADDRESS=unix:path=/run/user/$(id -u)/bus | |||
| export DISPLAY=:0.0 | |||
| # For individual configurations: | |||
| [ -d "$HOME/.local/share/password-store" ] && export PASSWORD_STORE_DIR="$HOME/.local/share/password-store" | |||
| pgrep i3blocks >/dev/null && STATUSBAR="i3blocks" || STATUSBAR="dwmblocks" | |||
| # Settings are different for MacOS (Darwin) systems. | |||
| if [ "$(uname)" = "Darwin" ]; then | |||
| notify() { osascript -e "display notification \"$2 in $1\" with title \"You've got Mail\" subtitle \"Account: $account\"" && sleep 2 ;} | |||
| messageinfo() { osascript -e "display notification with title \"📧 $from\" subtitle \"$subject\"" ;} | |||
| else | |||
| notify() { notify-send --app-name="mutt-wizard" "mutt-wizard" "📬 $2 new mail(s) in \`$1\` account." ;} | |||
| messageinfo() { notify-send --app-name="mutt-wizard" "📧$from:" "$subject" ;} | |||
| fi | |||
| # Check account for new mail. Notify if there is new content. | |||
| syncandnotify() { | |||
| acc="$(echo "$account" | sed "s/.*\///")" | |||
| mbsync "$acc" | |||
| mbsync "$opts" "$acc" | |||
| new=$(find "$HOME/.local/share/mail/$acc/INBOX/new/" "$HOME/.local/share/mail/$acc/Inbox/new/" "$HOME/.local/share/mail/$acc/inbox/new/" -type f -newer "$HOME/.config/mutt/.mailsynclastrun" 2> /dev/null) | |||
| newcount=$(echo "$new" | sed '/^\s*$/d' | wc -l) | |||
| if [ "$newcount" -gt "0" ]; then | |||
| @@ -37,8 +38,8 @@ syncandnotify() { | |||
| for file in $new; do | |||
| # Extract subject and sender from mail. | |||
| from=$(awk '/^From: / && ++n ==1,/^\<.*\>:/' "$file" | perl -CS -MEncode -ne 'print decode("MIME-Header", $_)' | awk '{ $1=""; if (NF>=3)$NF=""; print $0 }' | sed 's/^[[:blank:]]*[\"'\''\<]*//;s/[\"'\''\>]*[[:blank:]]*$//') | |||
| subject=$(awk '/^Subject: / && ++n == 1,/^\<.*\>: / && ++i == 2' "$file" | head -n-1 | perl -CS -MEncode -ne 'print decode("MIME-Header", $_)' | sed 's/^Subject: //' | sed 's/^{[[:blank:]]*[\"'\''\<]*//;s/[\"'\''\>]*[[:blank:]]*$//' | tr -d '\n') | |||
| notify-send --app-name="mutt-wizard" "📧$from:" "$subject" & | |||
| subject=$(awk '/^Subject: / && ++n == 1,/^\<.*\>: / && ++i == 2' "$file" | head -n 1 | perl -CS -MEncode -ne 'print decode("MIME-Header", $_)' | sed 's/^Subject: //' | sed 's/^{[[:blank:]]*[\"'\''\<]*//;s/[\"'\''\>]*[[:blank:]]*$//' | tr -d '\n') | |||
| messageinfo & | |||
| done | |||
| fi | |||
| } | |||
| @@ -47,11 +48,13 @@ syncandnotify() { | |||
| if [ "$#" -eq "0" ]; then | |||
| accounts="$(awk '/^Channel/ {print $2}' "$HOME/.mbsyncrc")" | |||
| else | |||
| for arg in "$@"; do | |||
| [ "${arg%${arg#?}}" = '-' ] && opts="${opts:+${opts} }${arg}" && shift 1 | |||
| done | |||
| accounts=$* | |||
| fi | |||
| echo " 🔃" > /tmp/imapsyncicon_"$USER" | |||
| ( pkill -RTMIN+12 "${STATUSBAR:?}" >/dev/null 2>&1 ) 2>/dev/null | |||
| ( kill -46 "$(pidof "${STATUSBAR:-dwmblocks}")" >/dev/null 2>&1 ) 2>/dev/null | |||
| # Parallelize multiple accounts | |||
| for account in $accounts | |||
| @@ -60,8 +63,7 @@ do | |||
| done | |||
| wait | |||
| rm -f /tmp/imapsyncicon_"$USER" | |||
| ( pkill -RTMIN+12 "${STATUSBAR:?}" >/dev/null 2>&1 ) 2>/dev/null | |||
| ( kill -46 "$(pidof "${STATUSBAR:-dwmblocks}")" >/dev/null 2>&1 ) 2>/dev/null | |||
| notmuch new 2>/dev/null | |||
| @@ -3,11 +3,11 @@ | |||
| command -V gpg >/dev/null 2>&1 && GPG="gpg" || GPG="gpg2" | |||
| [ -z ${PASSWORD_STORE_DIR+x} ] && PASSWORD_STORE_DIR="$HOME/.password-store" | |||
| [ -r "$PASSWORD_STORE_DIR/.gpg-id" ] && | |||
| "$GPG" --list-secret-keys $(cat "$PASSWORD_STORE_DIR/.gpg-id") >/dev/null 2>&1 || { | |||
| "$GPG" --list-secret-keys "$(cat "$PASSWORD_STORE_DIR/.gpg-id")" >/dev/null 2>&1 || { | |||
| printf "\`pass\` must be installed and initialized to encrypt passwords.\\nBe sure it is installed and run \`pass init <yourgpgemail>\`.\\nIf you don't have a GPG public private key pair, run \`%s --full-gen-key\` first.\\n" "$GPG" | |||
| exit | |||
| } | |||
| ! command -v mbsync >/dev/null && printf "\`mbsync\` must be installed to run mutt-wizard.\\n" && exit | |||
| ! command -v mbsync >/dev/null && printf "\`mbsync (isync package)\` must be installed to run mutt-wizard.\\n" && exit | |||
| prefix="/usr/local" | |||
| muttdir="$HOME/.config/mutt" # Main mutt config location | |||
| @@ -50,12 +50,11 @@ $starttlsoff | |||
| " | |||
| mbsync_profile="IMAPStore $title-remote | |||
| Host $imap | |||
| Port $iport | |||
| Port $iport | |||
| User $login | |||
| PassCmd \"pass mutt-wizard-$title\" | |||
| AuthMechs LOGIN | |||
| SSLType $ssltype | |||
| AuthMech LOGIN | |||
| CertificateFile $sslcert | |||
| MaildirStore $title-local | |||
| @@ -88,6 +87,11 @@ set header_cache = $cachedir/$title/headers | |||
| set message_cachedir = $cachedir/$title/bodies | |||
| set mbox_type = Maildir | |||
| set crypt_autosign = yes | |||
| set crypt_opportunistic_encrypt = yes | |||
| set pgp_self_encrypt = yes | |||
| set pgp_default_key = $keyid | |||
| bind index,pager gg noop | |||
| bind index,pager g noop | |||
| bind index,pager M noop | |||
| @@ -101,14 +105,20 @@ mutt_profile="# vim: filetype=neomuttrc | |||
| # muttrc file for account $title | |||
| set realname = \"$realname\" | |||
| set from = \"$fulladdr\" | |||
| set sendmail = \"$prefix/bin/msmtp -a $title\" | |||
| set sendmail = \"msmtp -a $title\" | |||
| alias me $realname <$fulladdr> | |||
| set folder = \"imaps://$fulladdr@$imap:$iport\" | |||
| set folder = \"imaps://$login@$imap:$iport\" | |||
| set imap_user = \"$login\" | |||
| set header_cache = $cachedir/$title/headers | |||
| set message_cachedir = $cachedir/$title/bodies | |||
| set imap_pass = \"\`pass mutt-wizard-$title\`\" | |||
| set crypt_autosign = yes | |||
| set crypt_opportunistic_encrypt = yes | |||
| set pgp_self_encrypt = yes | |||
| set pgp_default_key = $keyid | |||
| set mbox_type = Maildir | |||
| set ssl_starttls = yes | |||
| set ssl_force_tls = yes | |||
| @@ -127,6 +137,7 @@ fi | |||
| askinfo() { \ | |||
| printf "Insert the \033[31memail address\033[0m that you want to autoconfigure for mutt/mbsync\\n\tEmail: \033[36m" | |||
| read -r fulladdr | |||
| keyid=$("$GPG" --list-keys --with-colons "$fulladdr" | awk -F: '/^pub:/ { print $5 }') | |||
| printf "\033[0m" | |||
| while ! echo "$fulladdr" | grep "$emailre" >/dev/null; do | |||
| printf "That is not a valid \033[31memail address\033[0m, please retype the desired email.\\n\\nEmail: \033[36m\t" | |||
| @@ -137,7 +148,7 @@ askinfo() { \ | |||
| search_query=$domain | |||
| case "$domain" in | |||
| protonmail.com|protonmail.ch|pm.me) | |||
| search_query='protonmail.com' && break;; | |||
| search_query='protonmail.com' && return 1;; | |||
| *) | |||
| while : ; do | |||
| printf "\nIs your email hosted with Protonmail? [yes/no] " | |||
| @@ -292,7 +303,7 @@ choosecron() { ! pgrep cron >/dev/null && echo "No cron manager running. Install | |||
| read -r minnum | |||
| printf "\033[0m" | |||
| done | |||
| (crontab -l; echo "*/$minnum * * * * $(type mailsync | cut -d' ' -f3)") | crontab - && | |||
| (crontab -l; echo "*/$minnum * * * * $(type mailsync | cut -d' ' -f3)") >/dev/null | crontab - && | |||
| echo "Cronjob added. Mail will sync every $minnum minutes. Be sure you have your cron manager running." | |||
| fi ;} | |||
| @@ -322,7 +333,7 @@ name=$realname | |||
| primary_email=$fulladdr | |||
| [new] | |||
| tags=unread;inbox; | |||
| ignore= | |||
| ignore=.mbsyncstate;.uidvalidity | |||
| [search] | |||
| exclude_tags=deleted;spam; | |||
| [maildir] | |||
| @@ -331,7 +342,7 @@ synchronize_flags=true | |||
| gpg_path=$GPG" | |||
| echo "$nmbasic" > "$NOTMUCH_CONFIG" ;} | |||
| trap 'echo -e "\033[0m\n"; exit' STOP INT ABRT KILL | |||
| trap 'echo -e "\033[0m\n"; exit' INT ABRT | |||
| case "$1" in | |||
| ls) list ;; | |||
| @@ -1,7 +1,7 @@ | |||
| #!/bin/sh | |||
| # Helps open a file with xdg-open from mutt in a external program without weird side effects. | |||
| [ $(uname) = "Darwin" ] && opener="open" || opener="setsid xdg-open" | |||
| [ "$(uname)" = "Darwin" ] && opener="open" || opener="setsid xdg-open" | |||
| mkdir -p "/tmp/$USER-mutt-tmp" | |||
| file="/tmp/$USER-mutt-tmp/$(basename "$1")" | |||
| rm -f "$file" | |||
| @@ -6,7 +6,7 @@ mw \- mutt-wizard \- autoconfigure email accounts for neomutt and isync | |||
| <command> | |||
| .SH DESCRIPTION | |||
| .B mw | |||
| takes a user email account and sets up a terminal-based email interface with it for | |||
| takes a user email account and sets up a terminal-based email interface for it with | |||
| .B neomutt. | |||
| This can include offline email with | |||
| .B isync/mbsync | |||
| @@ -56,7 +56,7 @@ Neither | |||
| .B delete | |||
| or | |||
| .B purge | |||
| will delete downloaded mail for for safety (and time)'s sake. If you want to delete downloaded mail, do so manually by removing it from the directory above. | |||
| will delete downloaded mail for safety (and time)'s sake. If you want to delete downloaded mail, do so manually by removing it from the directory above. | |||
| .TP | |||
| .B Default settings | |||
| The mutt-wizard has many default settings that focus on making it aesthetically pleasing and supplying more vim-like bindings. These can be found in | |||
| @@ -4,6 +4,7 @@ ADDRESS,IMAP,imap port,SMTP,smtp port | |||
| aaathats3as.com,mail.cock.li,993,mail.cock.li,587 | |||
| accountant.com,imap.mail.com,993,smtp.mail.com,587 | |||
| activist.com,imap.mail.com,993,smtp.mail.com,587 | |||
| ad.unsw.edu.au,outlook.office365.com,993,smtp.office365.com,587 | |||
| adexec.com,imap.mail.com,993,smtp.mail.com,587 | |||
| airmail.cc,mail.cock.li,993,mail.cock.li,587 | |||
| allergist.com,imap.mail.com,993,smtp.mail.com,587 | |||
| @@ -44,6 +45,7 @@ chef.net,imap.mail.com,993,smtp.mail.com,587 | |||
| chemist.com,imap.mail.com,993,smtp.mail.com,587 | |||
| chrissx.ga,chrissx.ga,993,chrissx.ga,25 | |||
| clarkson.edu,imap.gmail.com,993,smtp.gmail.com,587 | |||
| clasnet.sunyocc.edu,outlook.office365.com,993,smtp.office365.com,587 | |||
| clerk.com,imap.mail.com,993,smtp.mail.com,587 | |||
| clubmember.org,imap.mail.com,993,smtp.mail.com,587 | |||
| cmail.carleton.ca,imap-mail.outlook.com,993,smtp-mail.outlook.com,587 | |||
| @@ -87,6 +89,7 @@ forthnet.gr,mail.forthnet.gr,993,smtp-auth.forthnet.gr,465 | |||
| fsmpi.rwth-aachen.de,mail.fsmpi.rwth-aachen.de,993,mail.fsmpi.rwth-aachen.de,465 | |||
| fsu-jena,exchange.uni-jena.de,993,smtp.uni-jena.de,587 | |||
| getbackinthe.kitchen,mail.cock.li,993,mail.cock.li,587 | |||
| gcc.edu,imap-mail.outlook.com,993,smtp-mail.outlook.com,587 | |||
| gmail.com,imap.gmail.com,993,smtp.gmail.com,587 | |||
| gmx.at,imap.gmx.net,993,mail.gmx.net,587 | |||
| gmx.com,imap.gmx.net,993,mail.gmx.net,587 | |||
| @@ -166,6 +169,7 @@ kipras.org,mail.kipras.org,993,mail.kipras.org,587 | |||
| krutt.org,mail.autistici.org,993,smtp.autistici.org,465 | |||
| kth.se,webmail.kth.se,993,smtp.kth.se,587 | |||
| lavabit.com,lavabit.com,993,lavabit.com,587 | |||
| librem.one,imap.librem.one,993,smtp.librem.one,465 | |||
| linuxmail.org,imap.mail.com,993,smtp.mail.com,587 | |||
| live.com,imap-mail.outlook.com,993,smtp-mail.outlook.com,587 | |||
| live.de,imap-mail.outlook.com,993,smtp-mail.outlook.com,587 | |||
| @@ -236,6 +240,7 @@ sapo.pt,imap.sapo.pt,993,smtp.sapo.pt,587 | |||
| smail.inf.h-brs.de,imap.inf.h-brs.de,993,smtp.inf.h-brs.de,587 | |||
| southwales.ac.uk,imap.gmail.com,993,smtp.gmail.com,587 | |||
| spoko.pl,imap.poczta.onet.pl,993,smtp.poczta.onet.pl,465 | |||
| st.amu.edu.pl,outlook.office365.com,993,smtp.office365.com,587 | |||
| stevens.edu,imap.outlook.com,993,smtp.outlook.com,587 | |||
| stronzi.org,mail.autistici.org,993,smtp.autistici.org,465 | |||
| stud.tu-darmstadt.de,imap.stud.tu-darmstadt.de,993,smtp.tu-darmstadt.de,465 | |||
| @@ -243,7 +248,7 @@ stud.uis.no,outlook.office365.com,993,smtp.office365.com,587 | |||
| stud.uni-bamberg.de,outlook.office365.com,993,smtp.office365.com,587 | |||
| student.rmit.edu.au,outlook.office365.com,993,smtp.office365.com,587 | |||
| student.tuwien.ac.at,mail.student.tuwien.ac.at,993,mail.student.tuwien.ac.at,587 | |||
| studenti.unipi.it,outlook.office365.com,995,smtp.office365.com,587 | |||
| studenti.unipi.it,outlook.office365.com,993,smtp.office365.com,587 | |||
| students.southwales.ac.uk,imap.gmail.com,993,smtp.gmail.com,587 | |||
| studio.unibo.it,outlook.office365.com,993,smtp.office365.com,587 | |||
| studio.unibo.it,outlook.office365.com,993,smtp.office365.com,587 | |||
| @@ -301,4 +306,7 @@ zaclys.net,mail.zaclys.net,993,mail.zaclys.net,465 | |||
| zoho.com,imap.zoho.com,993,smtp.zoho.com,465 | |||
| zohomail.eu,imap.zoho.eu,993,smtp.zoho.eu,465 | |||
| ymail.com,imap.mail.yahoo.com,993,smtp.mail.yahoo.com,465 | |||
| gcc.edu,imap-mail.outlook.com,993,smtp-mail.outlook.com,587 | |||
| unilodz.eu,outlook.office365.com,993,smtp.office365.com,587 | |||
| ethz.ch,mail.ethz.ch,993,mail.ethz.ch,587 | |||
| bocken.org,imap.gmail.com,993,smtp.gmail.com,465 | |||
| vxempire.xyz,vxempire.xyz,993,vxempire.xyz,587 | |||
| @@ -5,3 +5,4 @@ image/*; openfile %s ; | |||
| video/*; setsid mpv --quiet %s &; copiousoutput | |||
| application/pdf; openfile %s ; | |||
| application/pgp-encrypted; gpg -d '%s'; copiousoutput; | |||
| application/pgp-keys; gpg --import '%s'; copiousoutput; | |||
| @@ -46,7 +46,7 @@ bind index U undelete-message | |||
| bind index L limit | |||
| bind index h noop | |||
| bind index l display-message | |||
| bind index <space> tag-entry | |||
| bind index,query <space> tag-entry | |||
| #bind browser h goto-parent | |||
| macro browser h '<change-dir><kill-line>..<enter>' "Go to parent folder" | |||
| bind index,pager H view-raw-message | |||