1mutt(1) User Manuals mutt(1)
2
6 mutt - The Mutt Mail User Agent
7
9 mutt [-nRyzZ] [-e cmd] [-F file] [-m type] [-f file]
10 mutt [-Enx] [-e cmd] [-F file] [-H file] [-i file] [-s subj] [-b addr]
12 [-c addr] [-a file [...] --] addr|mailto_url [...]
13 mutt [-nx] [-e cmd] [-F file] [-s subj] [-b addr] [-c addr] [-a file
15 [...] --] addr|mailto_url [...] < message
16 mutt [-n] [-e cmd] [-F file] -p
18 mutt [-n] [-e cmd] [-F file] -A alias
20 mutt [-n] [-e cmd] [-F file] -Q query
22 mutt -v[v]
24 mutt -D
26
28 Mutt is a small but very powerful text based program for reading and
29 sending electronic mail under unix operating systems, including support
30 for color terminals, MIME, OpenPGP, and a threaded sorting mode.
31 Note: This manual page gives a brief overview of mutt's command line
33 options. You should find a copy of the full manual in
34 /usr/share/doc/mutt, in text, HTML, and/or PDF format.
35
37 -A alias
38 An expanded version of the given alias is passed to stdout.
39 -a file [...]
41 Attach a file to your message using MIME. When attaching single
42 or multiple files, separating filenames and recipient addresses
43 with "--" is mandatory, e.g. mutt -a image.jpg -- addr1 or mutt
44 -a img.jpg *.png -- addr1 addr2. The -a option must be placed
45 at the end of command line options.
46 -b address
48 Specify a blind-carbon-copy (BCC) recipient
49 -c address
51 Specify a carbon-copy (CC) recipient
52 -d level
54 If mutt was compiled with +DEBUG log debugging output to
55 ~/.muttdebug0. Level can range from 1-5 and effects verbosity.
56 A value of 2 is recommended.
57 -D Print the value of all configuration options to stdout.
59 -E Causes the draft file specified by -H or include file specified
61 by -i to be edited during message composition.
62 -e command
64 Specify a configuration command to be run after processing of
65 initialization files.
66 -f mailbox
68 Specify which mailbox to load.
69 -F muttrc
71 Specify an initialization file to read instead of ~/.muttrc
72 -h Display help.
74 -H draft
76 Specify a draft file which contains header and body to use to
77 send a message.
78 -i include
80 Specify a file to include into the body of a message.
81 -m type
83 specify a default mailbox type for newly created folders.
84 -n Causes Mutt to bypass the system configuration file.
86 -p Resume a postponed message.
88 -Q query
90 Query a configuration variables value. The query is executed
91 after all configuration files have been parsed, and any commands
92 given on the command line have been executed.
93 -R Open a mailbox in read-only mode.
95 -s subject
97 Specify the subject of the message.
98 -v Display the Mutt version number and compile-time definitions.
100 -vv Display license and copyright information.
102 -x Emulate the mailx compose mode.
104 -y Start Mutt with a listing of all mailboxes specified by the
106 mailboxes command.
107 -z When used with -f, causes Mutt not to start if there are no mes‐
109 sages in the mailbox.
110 -Z Causes Mutt to open the first mailbox specified by the mailboxes
112 command which contains new mail.
113 -- Treat remaining arguments as addr even if they start with a
115 dash. See also "-a" above.
116
118 EDITOR Specifies the editor to use if VISUAL is unset.
119 EMAIL The user's e-mail address.
121 HOME Full path of the user's home directory.
123 MAIL Full path of the user's spool mailbox.
125 MAILDIR
127 Full path of the user's spool mailbox if MAIL is unset. Com‐
128 monly used when the spool mailbox is a maildir (5) folder.
129 MAILCAPS
131 Path to search for mailcap files.
132 MM_NOASK
134 If this variable is set, mailcap are always used without prompt‐
135 ing first.
136 PGPPATH
138 Directory in which the user's PGP public keyring can be found.
139 When used with the original PGP program, mutt and mutt_pgpring
140 [1m(1) rely on this being set.
141 TMPDIR Directory in which temporary files are created.
143 REPLYTO
145 Default Reply-To address.
146 VISUAL Specifies the editor to use when composing messages.
148
150 ~/.muttrc or ~/.mutt/muttrc
151 User configuration file.
152 /etc/Muttrc
154 System-wide configuration file.
155 /tmp/muttXXXXXX
157 Temporary files created by Mutt.
158 ~/.mailcap
160 User definition for handling non-text MIME types.
161 /etc/mailcap
163 System definition for handling non-text MIME types.
164 ~/.mime.types
166 User's personal mapping between MIME types and file extensions.
167 /etc/mime.types
169 System mapping between MIME types and file extensions.
170 /usr/bin/mutt_dotlock
172 The privileged dotlocking program.
173 /usr/share/doc/mutt/manual.txt
175 The Mutt manual.
176
178 None. Mutts have fleas, not bugs.
179
181 Suspend/resume while editing a file with an external editor does not
182 work under SunOS 4.x if you use the curses lib in /usr/5lib. It does
183 work with the S-Lang library, however.
184 Resizing the screen while using an external pager causes Mutt to go
186 haywire on some systems.
187 Suspend/resume does not work under Ultrix.
189 The help line for the index menu is not updated if you change the bind‐
191 ings for one of the functions listed while Mutt is running.
192 For a more up-to-date list of bugs, errm, fleas, please visit the mutt
194 project's bug tracking system under https://git‐
195 lab.com/muttmua/mutt/issues.
196
198 This program is distributed in the hope that it will be useful, but
199 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
200 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
201 Public License for more details.
202
204 curses(3), mailcap(5), maildir(5), mbox(5), mutt_dotlock(1), muttrc(5),
205 ncurses(3), sendmail(1), smail(1).
206 Mutt Home Page: http://www.mutt.org/
208 The Mutt manual
210
212 Michael Elkins, and others. Use <mutt-dev@mutt.org> to contact the
213 developers.
214Unix January 2009 mutt(1)