The Mutt E-Mail Client

Michael Elkins

version 1.5.13 (2006-08-11)

Abstract

``All mail clients suck. This one just sucks less.'' -me, circa 1995


Table of Contents

1. Introduction
1. Mutt Home Page
2. Mailing Lists
3. Software Distribution Sites
4. IRC
5. USENET
6. Copyright
2. Getting Started
1. Moving Around in Menus
2. Editing Input Fields
2.1. Introduction
2.2. History
3. Reading Mail - The Index and Pager
3.1. The Message Index
3.2. The Pager
3.3. Threaded Mode
3.4. Miscellaneous Functions
4. Sending Mail
4.1. Editing the message header
4.2. Using Mutt with PGP
4.3. Sending anonymous messages via mixmaster.
5. Forwarding and Bouncing Mail
6. Postponing Mail
3. Configuration
1. Syntax of Initialization Files
2. Defining/Using aliases
3. Changing the default key bindings
4. Defining aliases for character sets
5. Setting variables based upon mailbox
6. Keyboard macros
7. Using color and mono video attributes
8. Ignoring (weeding) unwanted message headers
9. Alternative addresses
10. Mailing lists
11. Using Multiple spool mailboxes
12. Defining mailboxes which receive mail
13. User defined headers
14. Defining the order of headers when viewing messages
15. Specify default save filename
16. Specify default Fcc: mailbox when composing
17. Specify default save filename and default Fcc: mailbox at once
18. Change settings based upon message recipients
19. Change settings before formatting a message
20. Choosing the cryptographic key of the recipient
21. Adding key sequences to the keyboard buffer
22. Executing functions
23. Message Scoring
24. Spam detection
25. Setting and Querying Variables
25.1. Commands
25.2. User-defined variables
26. Reading initialization commands from another file
27. Removing hooks
4. Advanced Usage
1. Regular Expressions
2. Patterns
2.1. Pattern Modifier
2.2. Complex Patterns
2.3. Searching by Date
3. Using Tags
4. Using Hooks
4.1. Message Matching in Hooks
5. External Address Queries
6. Mailbox Formats
7. Mailbox Shortcuts
8. Handling Mailing Lists
9. Editing threads
9.1. Linking threads
9.2. Breaking threads
10. Delivery Status Notification (DSN) Support
11. POP3 Support (OPTIONAL)
12. IMAP Support (OPTIONAL)
12.1. The Folder Browser
12.2. Authentication
13. Managing multiple IMAP/POP accounts (OPTIONAL)
14. Start a WWW Browser on URLs (EXTERNAL)
15. Local caching (OPTIONAL)
15.1. Header caching
15.2. Body caching
5. Mutt's MIME Support
1. Using MIME in Mutt
1.1. Viewing MIME messages in the pager
1.2. The Attachment Menu
1.3. The Compose Menu
2. MIME Type configuration with mime.types
3. MIME Viewer configuration with mailcap
3.1. The Basics of the mailcap file
3.2. Secure use of mailcap
3.3. Advanced mailcap Usage
3.4. Example mailcap files
4. MIME Autoview
5. MIME Multipart/Alternative
6. Attachment Searching and Counting
7. MIME Lookup
6. Reference
1. Command line options
2. Configuration Commands
3. Configuration variables
3.1. abort_nosubject
3.2. abort_unmodified
3.3. alias_file
3.4. alias_format
3.5. allow_8bit
3.6. allow_ansi
3.7. arrow_cursor
3.8. ascii_chars
3.9. askbcc
3.10. askcc
3.11. attach_format
3.12. attach_sep
3.13. attach_split
3.14. attribution
3.15. autoedit
3.16. auto_tag
3.17. beep
3.18. beep_new
3.19. bounce
3.20. bounce_delivered
3.21. braille_friendly
3.22. charset
3.23. check_new
3.24. collapse_unread
3.25. uncollapse_jump
3.26. compose_format
3.27. config_charset
3.28. confirmappend
3.29. confirmcreate
3.30. connect_timeout
3.31. content_type
3.32. copy
3.33. crypt_use_gpgme
3.34. crypt_autopgp
3.35. crypt_autosmime
3.36. date_format
3.37. default_hook
3.38. delete
3.39. delete_untag
3.40. digest_collapse
3.41. display_filter
3.42. dotlock_program
3.43. dsn_notify
3.44. dsn_return
3.45. duplicate_threads
3.46. edit_headers
3.47. editor
3.48. encode_from
3.49. envelope_from_address
3.50. escape
3.51. fast_reply
3.52. fcc_attach
3.53. fcc_clear
3.54. folder
3.55. folder_format
3.56. followup_to
3.57. force_name
3.58. forward_decode
3.59. forward_edit
3.60. forward_format
3.61. forward_quote
3.62. from
3.63. gecos_mask
3.64. hdrs
3.65. header
3.66. help
3.67. hidden_host
3.68. hide_limited
3.69. hide_missing
3.70. hide_thread_subject
3.71. hide_top_limited
3.72. hide_top_missing
3.73. history
3.74. honor_followup_to
3.75. hostname
3.76. ignore_list_reply_to
3.77. imap_authenticators
3.78. imap_check_subscribed
3.79. imap_delim_chars
3.80. imap_headers
3.81. imap_home_namespace
3.82. imap_idle
3.83. imap_keepalive
3.84. imap_list_subscribed
3.85. imap_login
3.86. imap_pass
3.87. imap_passive
3.88. imap_peek
3.89. imap_servernoise
3.90. imap_user
3.91. implicit_autoview
3.92. include
3.93. include_onlyfirst
3.94. indent_string
3.95. index_format
3.96. ispell
3.97. keep_flagged
3.98. locale
3.99. mail_check
3.100. mailcap_path
3.101. mailcap_sanitize
3.102. header_cache
3.103. maildir_header_cache_verify
3.104. header_cache_pagesize
3.105. header_cache_compress
3.106. maildir_trash
3.107. mark_old
3.108. markers
3.109. mask
3.110. mbox
3.111. mbox_type
3.112. metoo
3.113. menu_context
3.114. menu_move_off
3.115. menu_scroll
3.116. meta_key
3.117. mh_purge
3.118. mh_seq_flagged
3.119. mh_seq_replied
3.120. mh_seq_unseen
3.121. mime_forward
3.122. mime_forward_decode
3.123. mime_forward_rest
3.124. mix_entry_format
3.125. mixmaster
3.126. move
3.127. message_cachedir
3.128. message_format
3.129. narrow_tree
3.130. net_inc
3.131. pager
3.132. pager_context
3.133. pager_format
3.134. pager_index_lines
3.135. pager_stop
3.136. crypt_autosign
3.137. crypt_autoencrypt
3.138. pgp_ignore_subkeys
3.139. crypt_replyencrypt
3.140. crypt_replysign
3.141. crypt_replysignencrypted
3.142. crypt_timestamp
3.143. pgp_use_gpg_agent
3.144. crypt_verify_sig
3.145. smime_is_default
3.146. smime_ask_cert_label
3.147. smime_decrypt_use_default_key
3.148. pgp_entry_format
3.149. pgp_good_sign
3.150. pgp_check_exit
3.151. pgp_long_ids
3.152. pgp_retainable_sigs
3.153. pgp_autoinline
3.154. pgp_replyinline
3.155. pgp_show_unusable
3.156. pgp_sign_as
3.157. pgp_strict_enc
3.158. pgp_timeout
3.159. pgp_sort_keys
3.160. pgp_mime_auto
3.161. pgp_auto_decode
3.162. pgp_decode_command
3.163. pgp_getkeys_command
3.164. pgp_verify_command
3.165. pgp_decrypt_command
3.166. pgp_clearsign_command
3.167. pgp_sign_command
3.168. pgp_encrypt_sign_command
3.169. pgp_encrypt_only_command
3.170. pgp_import_command
3.171. pgp_export_command
3.172. pgp_verify_key_command
3.173. pgp_list_secring_command
3.174. pgp_list_pubring_command
3.175. forward_decrypt
3.176. smime_timeout
3.177. smime_encrypt_with
3.178. smime_keys
3.179. smime_ca_location
3.180. smime_certificates
3.181. smime_decrypt_command
3.182. smime_verify_command
3.183. smime_verify_opaque_command
3.184. smime_sign_command
3.185. smime_sign_opaque_command
3.186. smime_encrypt_command
3.187. smime_pk7out_command
3.188. smime_get_cert_command
3.189. smime_get_signer_cert_command
3.190. smime_import_cert_command
3.191. smime_get_cert_email_command
3.192. smime_default_key
3.193. ssl_client_cert
3.194. ssl_force_tls
3.195. ssl_starttls
3.196. certificate_file
3.197. ssl_usesystemcerts
3.198. entropy_file
3.199. ssl_use_sslv2
3.200. ssl_use_sslv3
3.201. ssl_use_tlsv1
3.202. ssl_min_dh_prime_bits
3.203. ssl_ca_certificates_file
3.204. pipe_split
3.205. pipe_decode
3.206. pipe_sep
3.207. pop_authenticators
3.208. pop_auth_try_all
3.209. pop_checkinterval
3.210. pop_delete
3.211. pop_host
3.212. pop_last
3.213. pop_reconnect
3.214. pop_user
3.215. pop_pass
3.216. post_indent_string
3.217. postpone
3.218. postponed
3.219. preconnect
3.220. print
3.221. print_command
3.222. print_decode
3.223. print_split
3.224. prompt_after
3.225. query_command
3.226. quit
3.227. quote_regexp
3.228. read_inc
3.229. read_only
3.230. realname
3.231. recall
3.232. record
3.233. reply_regexp
3.234. reply_self
3.235. reply_to
3.236. resolve
3.237. reverse_alias
3.238. reverse_name
3.239. reverse_realname
3.240. rfc2047_parameters
3.241. save_address
3.242. save_empty
3.243. save_name
3.244. score
3.245. score_threshold_delete
3.246. score_threshold_flag
3.247. score_threshold_read
3.248. send_charset
3.249. sendmail
3.250. sendmail_wait
3.251. shell
3.252. sig_dashes
3.253. sig_on_top
3.254. signature
3.255. simple_search
3.256. smart_wrap
3.257. smileys
3.258. sleep_time
3.259. sort
3.260. sort_alias
3.261. sort_aux
3.262. sort_browser
3.263. sort_re
3.264. spam_separator
3.265. spoolfile
3.266. status_chars
3.267. status_format
3.268. status_on_top
3.269. strict_threads
3.270. suspend
3.271. text_flowed
3.272. thread_received
3.273. thorough_search
3.274. tilde
3.275. timeout
3.276. tmpdir
3.277. to_chars
3.278. tunnel
3.279. use_8bitmime
3.280. use_domain
3.281. use_envelope_from
3.282. use_from
3.283. use_idn
3.284. use_ipv6
3.285. user_agent
3.286. visual
3.287. wait_key
3.288. weed
3.289. wrap_search
3.290. wrapmargin
3.291. write_inc
3.292. write_bcc
4. Functions
4.1. generic
4.2. index
4.3. pager
4.4. alias
4.5. query
4.6. attach
4.7. compose
4.8. postpone
4.9. browser
4.10. pgp
4.11. editor
7. Miscellany
1. Acknowledgements
2. About this document

List of Tables

2.1. Most common navigation keys
2.2. Most common line editor keys
2.3. Most common message index keys
2.4. Most common pager keys
2.5. Most common thread mode keys
2.6. Most common mail sending keys
2.7. Most common compose menu keys
2.8. PGP key menu flags
2.9. Message forwarding/bouncing keys
3.1. Symbolic key names
4.1. Pattern modifiers
6.1. Command line options
6.2. Default generic function bindings
6.3. Default index menu function bindings
6.4. Default pager menu function bindings
6.5. Default alias menu function bindings
6.6. Default query menu function bindings
6.7. Default attach menu function bindings
6.8. Default compose menu function bindings
6.9. Default postpone menu function bindings
6.10. Default browser menu function bindings
6.11. Default pgp menu function bindings
6.12. Default editor function bindings