You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

mw.1 7.6 KiB

5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228
  1. .TH MW 1 mutt-wizard
  2. .SH NAME
  3. mw \- mutt-wizard \- autoconfigure email accounts for neomutt and isync
  4. .SH SYNOPSIS
  5. .B mw
  6. <command>
  7. .SH DESCRIPTION
  8. .B mw
  9. takes a user email account and sets up a terminal-based email interface with it for
  10. .B neomutt.
  11. This can include offline email with
  12. .B isync/mbsync
  13. and configs for
  14. .B msmtp
  15. for sending mail, and also passwords automatically encrypted and stored with
  16. .B pass.
  17. .SH COMMANDS
  18. .TP
  19. .B add
  20. configure an email account
  21. .TP
  22. .B ls
  23. list all email accounts configured by mutt-wizard
  24. .TP
  25. .B delete
  26. delete the configuration files for an already configured email account
  27. .TP
  28. .B purge
  29. totally purge all local mutt-wizard accounts
  30. .TP
  31. .B cron
  32. toggle a cronjob that will automatically sync mail with
  33. .B mailsync
  34. as often as you wish
  35. .SH DETAILS
  36. .TP
  37. .B Mail location
  38. If the user chooses to keep offline email with
  39. .B isync,
  40. it will be kept in
  41. .I ~/.local/share/mail/.
  42. .B notmuch
  43. can be used to index and search this mail by giving this directory when first running
  44. .B notmuch setup.
  45. .TP
  46. .B muttrc files
  47. mutt-wizard will create a muttrc file for each created account holding account-specific details. These will appear in
  48. .I ~/.config/mutt/accounts/
  49. and can be edited by the user if needbe. Note that the mutt-wizard will also source these files and create the bindings to switch between them, and these will appear in your default
  50. .I ~/.config/mutt/muttrc
  51. file.
  52. .TP
  53. .B Mail deletion
  54. Neither
  55. .B delete
  56. or
  57. .B purge
  58. 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.
  59. .TP
  60. .B Default settings
  61. 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
  62. .I /usr/share/mutt-wizard/mutt-wizard.muttrc
  63. and the default mailcap file can be found in
  64. .I
  65. /usr/share/mutt-wizard/mailcap.
  66. Any of these settings can be overwritten in
  67. .I ~/.config/mutt/muttrc,
  68. but be mindful that your overriding binds should appear after the
  69. .I
  70. mutt-wizard.muttrc
  71. file is sourced.
  72. .TP
  73. .B Detecting server settings
  74. mutt-wizard has a repository of email services and their server information kept in
  75. .I /usr/share/mutt-wizard/domains.csv
  76. which is used to automatically configure email settings.
  77. If your email provider is not found there, it will prompt you to input your email service's IMAP and SMTP server information which can usually be found by searching online.
  78. If you would like to help develop mutt-wizard for others, you are invited to add this service information to
  79. .I domains.csv
  80. on mutt-wizard's Github <https://github.com/lukesmithxyz/mutt-wizard> or Gitlab <https://gitlab.com/lukesmithxyz/mutt-wizard> pages.
  81. .TP
  82. .B Gmail accounts
  83. Google will require you to allow "less-secure" (third party) applications or use two-factor authentication in order to access their IMAP servers to download your mail. If you use Gmail, be sure to handle this before running mutt-wizard <https://support.google.com/accounts/answer/6010255>.
  84. .B Protonmail accounts
  85. Protonmail users must use the Protonmail Bridge <https://protonmail.com/bridge/> to access their IMAP and SMTP servers. This too should be configured before running mutt-wizard.
  86. .B Enterprise and university accounts
  87. Many universities and businesses might host their domain's email via Google or another service. This often requires a special IMAP/SMTP-specific password that you must generate and use. Again, mutt-wizard can handle these systems, but only once they've been set up.
  88. .TP
  89. .B Password decryption
  90. mutt-wizard uses
  91. .I pass
  92. and therefore
  93. .I gpg
  94. to decrypt your passwords. Provided your GPG key has a password, this might mean that you will be prompted for your GPG password the first time you sync or send mail in a session. Once your password is cached, it might also expire later as well.
  95. Because of this I strongly recommend the program
  96. .I pam-gnupg
  97. <https://github.com/cruegge/pam-gnupg> which automatically unlocks your GPG password on login and keeps it active, thus giving you, with mutt-wizard, secure access to all your email accounts on your system without ever having to input a password.
  98. If you don't want to use this program, you can also increase the cache time of an inputted GPG password with the
  99. .I default-cache-ttl
  100. and
  101. .I max-cache-ttl
  102. variables in your
  103. .I
  104. gpg-agent.conf.
  105. .SH MUTT-WIZARD'S NEOMUTT CONFIGURATION
  106. Here is a list of not only mutt-wizard's particular defaults, but what you need to get the most out of email accounts configured with mutt-wizard.
  107. .TP
  108. .B Color
  109. The mutt-wizard's default settings add color to messages in the index and color mail details to make them easier to see. New mail, in addition to being marked by the typical N, will also be bold.
  110. .TP
  111. .B Movement with h/j/k/l
  112. Use vim keys to move down
  113. .I j
  114. or up
  115. .I k
  116. in mail, while
  117. .I l
  118. opens mail, then the attachment view, then an attachment, while
  119. .I h
  120. is the reverse.
  121. While mail is open, go to next or previous mail with
  122. .I J
  123. and
  124. .I K.
  125. In the mail index,
  126. .I d
  127. and
  128. .I u
  129. go down and up by a half page and
  130. .I gg
  131. and
  132. .I G
  133. go to the very top and very bottom.
  134. .TP
  135. .B Search mail
  136. If you have
  137. .B notmuch
  138. configured with your proper mail directory (see above), you may run
  139. .I ctrl-f
  140. to search for mail containing any given sequence.
  141. Even without notmuch,
  142. .I L
  143. limits mail, showing only those with the given sequence in the subject while
  144. .I A
  145. shows all mail (same as limiting to "all").
  146. .TP
  147. .B Deleting mail
  148. .I D
  149. deletes mail, while
  150. .I U
  151. undeletes it (type in mail number to get to deleted mail). Note that
  152. .I S
  153. saves your mailbox, finalizing deletion. If you have a
  154. .I Trash
  155. box, deleted mail is moved there. If you want it to skip that and simply be deleted, comment out or remove the
  156. .I set trash
  157. line in that account's muttrc.
  158. .TP
  159. .B Send mail
  160. .I m
  161. creates a new mail message;
  162. .I r
  163. replies to the selected message;
  164. .I R
  165. replies all to the selected message and
  166. .I f
  167. fowards the selected message.
  168. .TP
  169. .B Compose mail screen
  170. Once you write mail and save the buffer you will be brought to the compose screen. Press
  171. .I a
  172. to add attachments, use
  173. .I s/t/c/b/d
  174. to change the subject/to/CC/BCC/description. Press
  175. .I S
  176. to change the signature/encryption. Press
  177. .I y
  178. to send the mail.
  179. .TP
  180. .B Saving and autocompleting email addresses with abook
  181. Install the optional dependency abook and you will be able to save the sender's email address with
  182. .I a.
  183. Once this is done, when you are typing in any email/contact prompt, you may press
  184. .I Tab
  185. to find contacts matching your input. Although abook is often used with mutt, it is also a useful program in its own right.
  186. .TP
  187. .B Switching and moving mail between mailboxes
  188. The
  189. .I g
  190. key can be paired with several other keys to automatically move to another mailbox: gi: Inbox; gs: Sent; gd: Drafts; ga: Archive; gS: Spam; gj: Junk; gt: Trash. These bindings will only be present for accounts that have the boxes in question. Instead of
  191. .I g,
  192. you can also press
  193. .I C
  194. to copy mail or
  195. .I M
  196. to move mail to the same boxes.
  197. .TP
  198. .B Switching between accounts
  199. mutt-wizard can configure as many as nine accounts each numbered by the lowest available number when configured. Press
  200. .I i
  201. followed by an account's number to change to that account: i2, i5, etc.
  202. .TP
  203. .B Sidebar
  204. mutt-wizard enables the sidebar by default which displays your account's boxes with mail tallies.
  205. .I B
  206. will toggle the sidebar. Move up and down in it with
  207. .I ctrl-k/j.
  208. Open a box with
  209. .I ctrl-o.
  210. .TP
  211. .B More information
  212. Remember that you can press
  213. .I ?
  214. at any time in neomutt to get a list of all key-bindings and functions. This list can also vary for different context menus.
  215. .SH AUTHORS
  216. Written by Luke Smith <luke@lukesmith.xyz> originally in 2018.
  217. .SH LICENSE
  218. GPLv3
  219. .SH SEE ALSO
  220. .BR neomutt (1),
  221. .BR neomuttrc (1)
  222. .BR mbsync (1),
  223. .BR msmtp (1),
  224. .BR notmuch (1),
  225. .BR abook (1)