1neomutt(1) User Manuals neomutt(1)
2
6 neomutt - The NeoMutt Mail User Agent (MUA)
7
9 neomutt [-Enx] [-e command] [-F config] [-H draft] [-i include]
10 [-b address] [-c address] [-s subject] [-a file [...] --]
11 address [...]
12 neomutt [-nx] [-e command] [-F config] [-b address] [-c address]
14 [-s subject] [-a file [...] --] address [...] < message
15 neomutt [-nRy] [-e command] [-F config] [-f mailbox] [-m type]
17 neomutt [-n] [-e command] [-F config] -A alias
19 neomutt [-n] [-e command] [-F config] -B
21 neomutt [-n] [-e command] [-F config] -D [-S] [-O]
23 neomutt [-n] [-e command] [-F config] -d level -l file
25 neomutt [-n] [-e command] [-F config] -G
27 neomutt [-n] [-e command] [-F config] -g server
29 neomutt [-n] [-e command] [-F config] -p
31 neomutt [-n] [-e command] [-F config] -Q variable [-O]
33 neomutt [-n] [-e command] [-F config] -Z
35 neomutt [-n] [-e command] [-F config] -z [-f mailbox]
37 neomutt -v[v]
39
41 NeoMutt is a small but very powerful text based program for reading and
42 sending electronic mail under Unix operating systems, including support
43 for color terminals, MIME, OpenPGP, and a threaded sorting mode.
44 Note: This manual page gives a brief overview of NeoMutt's command line
46 options. You should find a copy of the full manual in
47 /usr/share/doc/neomutt, in plain text, HTML, and/or PDF format.
48
50 -- Special argument forces NeoMutt to stop option parsing and treat
51 remaining arguments as addresses even if they start with a dash
52 -A alias
54 Print an expanded version of the given alias to stdout and exit
55 -a file
57 Attach one or more files to a message (must be the last option).
58 Add any addresses after the '--' argument, e.g.:
59 neomutt -a image.jpg -- address1
61 neomutt -a image.jpg *.png -- address1 address2
62 -B Run in batch mode (do not start the ncurses UI)
64 -b address
66 Specify a blind carbon copy (Bcc) recipient
67 -c address
69 Specify a carbon copy (Cc) recipient
70 -D Dump all configuration variables as 'name=value' pairs to stdout
72 -D -O Like -D, but show one-liner documentation
74 -D -S Like -D, but hide the value of sensitive variables
76 -d level
78 Log debugging output to a file (default is "~/.neomuttdebug0").
79 The level can range from 1–5 and affects verbosity (a value of 2
80 is recommended)
81 Using this option along with -l is useful to log the early
83 startup process (before reading any configuration and hence $de‐
84 bug_level and $debug_file)
85 -E Edit draft (-H) or include (-i) file during message composition
87 -e command
89 Specify a command to be run after reading the config files
90 -F config
92 Specify an alternative initialization file to read, see FILES
93 section below for a list of regular configuration files
94 -f mailbox
96 Specify a mailbox (as defined with mailboxes command) to load
97 -G Start NeoMutt with a listing of subscribed newsgroups
99 -g server
101 Like -G, but start at specified news server -H draft Specify a
102 draft file which contains header and body to use to send a mes‐
103 sage. If draft is “-”, then data is read from stdin. The draft
104 file is expected to contain just an RFC822 email — headers and a
105 body. Although it is not an mbox file, if an mbox "From " line
106 is present, it will be silently discarded.
107 -h Print this help message and exit
109 -i include
111 Specify an include file to be embedded in the body of a message
112 -l file
114 Specify a file for debugging output (default "~/.neomuttdebug0")
115 This overrules $debug_file setting and NeoMutt keeps up to five
117 debug logs ({ file | $debug_file | ~/.neomuttdebug }[0-4]) be‐
118 fore override the oldest file
119 -m type
121 Specify a default mailbox format type for newly created folders
122 The type is either MH, MMDF, Maildir or mbox (case-insensitive)
124 -n Do not read the system-wide configuration file
126 -p Resume a prior postponed message, if any
128 -Q variable
130 Query a configuration variable and print its value to stdout
131 (after the config has been read and any commands executed). Add
132 -O for one-liner documentation.
133 -R Open mailbox in read-only mode
135 -s subject
137 Specify a subject (must be enclosed in quotes if it has spaces)
138 -v Print the NeoMutt version and compile-time definitions and exit
140 -vv Print the NeoMutt license and copyright information and exit
142 -y Start NeoMutt with a listing of all defined mailboxes
144 -Z Open the first mailbox with new message or exit immediately with
146 exit code 1 if none is found in all defined mailboxes
147 -z Open the first or specified (-f) mailbox if it holds any message
149 or exit immediately with exit code 1 otherwise
150
152 EDITOR Specifies the editor to use if VISUAL is unset. Defaults to the
153 Vi editor if unset.
154 EGDSOCKET
156 For OpenSSL since version 0.9.5, files, mentioned at RANDFILE
157 below, can be Entropy Gathering Daemon (EGD) sockets. Also, and
158 if exists, ~/.entropy and /tmp/entropy will be used to initial‐
159 ize SSL library functions. Specified sockets must be owned by
160 the user and have permission of 600 (octal number representing).
161 EMAIL The user's email address.
163 HOME Full path of the user's home directory.
165 MAIL Full path of the user's spool mailbox.
167 MAILCAPS
169 Path to search for mailcap files. If unset, a RFC1524 compliant
170 search path that is extended with NeoMutt related paths (at po‐
171 sition two and three): "$HOME/.mailcap:/usr/share/neomutt/mail‐
172 cap:/etc/mailcap:/etc/mailcap:/usr/etc/mailcap:/usr/local/etc/
173 mailcap" will be used instead.
174 MAILDIR
176 Full path of the user's spool mailbox if MAIL is unset. Commonly
177 used when the spool mailbox is a maildir(5) folder.
178 MM_NOASK
180 If this variable is set, mailcap are always used without prompt‐
181 ing first.
182 NNTPSERVER
184 Similar to configuration variable $news_server, specifies the
185 domain name or address of the default NNTP server to connect. If
186 unset, /etc/nntpserver is used but can be overridden by command
187 line option -g.
188 RANDFILE
190 Like configuration variable $entropy_file, defines a path to a
191 file which includes random data that is used to initialize SSL
192 library functions. If unset, ~/.rnd is used. DO NOT store impor‐
193 tant data in the specified file.
194 REPLYTO
196 When set, specifies the default Reply-To address.
197 TEXTDOMAINDIR
199 Defines an absolute path corresponding to /usr/share/locale that
200 will be recognised by GNU gettext(1) and used for Native Lan‐
201 guage Support (NLS) if enabled.
202 TMPDIR Directory in which temporary files are created. Defaults to /tmp
204 if unset. Configuration variable $tmpdir takes precedence over
205 this one.
206 VISUAL Specifies the editor to use when composing messages.
208 XDG_CONFIG_DIRS
210 Specifies a X Desktop Group (XDG) compliant location for the
211 system-wide configuration file, as described in FILES section
212 below. This variable defaults to /etc/xdg. Bypass loading with
213 command line option -n.
214 XDG_CONFIG_HOME
216 Specifies a XDG compliant location for the user-specific config‐
217 uration file, as described in FILES section below. This variable
218 defaults to $HOME/.config. Can be overridden by command line op‐
219 tion -F.
220
222 Configuration files
223 NeoMutt will read just the first found configuration file of system-
224 wide and user-specific category, from the list below and in that order.
225 But it allows building of a recursive configuration by using the source
227 command.
228 ┌────┬────────────────────────────────┬────────────────────────────────┐
230 │ #N │ system-wide │ user-specific │
231 ├────┼────────────────────────────────┼────────────────────────────────┤
232 │ 1 │ $XDG_CONFIG_DIRS/neomutt/ │ $XDG_CONFIG_HOME/neomutt/ │
233 │ │ neomuttrc │ neomuttrc │
234 ├────┼────────────────────────────────┼────────────────────────────────┤
235 │ 2 │ $XDG_CONFIG_DIRS/neomutt/ │ $XDG_CONFIG_HOME/neomutt/ │
236 │ │ Muttrc *) │ muttrc │
237 ├────┼────────────────────────────────┼────────────────────────────────┤
238 │ 3 │ /etc/neomuttrc │ $XDG_CONFIG_HOME/mutt/ │
239 │ │ │ neomuttrc │
240 ├────┼────────────────────────────────┼────────────────────────────────┤
241 │ 4 │ /etc/Muttrc *) │ $XDG_CONFIG_HOME/mutt/muttrc │
242 ├────┼────────────────────────────────┼────────────────────────────────┤
243 │ 5 │ /usr/share/neomutt/neomuttrc │ ~/.neomutt/neomuttrc │
244 ├────┼────────────────────────────────┼────────────────────────────────┤
245 │ 6 │ /usr/share/neomutt/Muttrc *) │ ~/.neomutt/muttrc │
246 ├────┼────────────────────────────────┼────────────────────────────────┤
247 │ 7 │ — │ ~/.mutt/neomuttrc │
248 ├────┼────────────────────────────────┼────────────────────────────────┤
249 │ 8 │ — │ ~/.mutt/muttrc │
250 ├────┼────────────────────────────────┼────────────────────────────────┤
251 │ 9 │ — │ ~/.neomuttrc │
252 ├────┼────────────────────────────────┼────────────────────────────────┤
253 │ 10 │ — │ ~/.muttrc │
254 ├────┴────────────────────────────────┴────────────────────────────────┤
255 │ *) Note the case of the filename │
256 └──────────────────────────────────────────────────────────────────────┘
257 Other relevant files
258 Unless otherwise stated, NeoMutt will process all grouped files in the
259 order (from top to bottom) as they are specified in that listing.
260 ~/.mailcap
262 /etc/mailcap
263 User-specific and system-wide definitions for handling non-text
264 MIME types, look at environment variable MAILCAPS above for ad‐
265 ditional search locations.
266 ~/.neomuttdebug0
268 User's default debug log file. For further details or customis‐
269 ing file path see command line options -d and -l above.
270 /etc/mime.types
272 /etc/mime.types
273 /usr/share/neomutt/mime.types
274 ~/.mime.types
275 Description files for simple plain text mapping between MIME
276 types and filename extensions. NeoMutt parses these files in the
277 stated order while processing attachments to determine their
278 MIME type.
279 /usr/share/doc/neomutt/manual.{html,pdf,txt}
281 The full NeoMutt manual in HTML, PDF or plain text format.
282 /tmp/neomutt-XXXX-XXXX-XXXX
284 Temporary files created by NeoMutt. For custom locations look at
285 description of the environment variable TMPDIR above. Notice
286 that the suffix -XXXX-XXXX-XXXX is just a placeholder for, e.g.
287 hostname, user name/ID, process ID and/or other random data.
288
290 See issue tracker at <https://github.com/neomutt/neomutt/issues>.
291
293 This program is distributed in the hope that it will be useful, but
294 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
295 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
296 Public License for more details.
297
299 gettext(1), msmtp(1), notmuch(1), sendmail(1), smail(1), RAND_egd(3),
300 curses(3), ncurses(3), mailcap(5), maildir(5), mbox(5), neomuttrc(5).
301 For further NeoMutt information:
303 • the full manual, see FILES section above
305 • the home page, <https://neomutt.org>
306
308 Michael Elkins, and others. Use <neomutt-devel@neomutt.org> to contact
309 the developers.
310Unix 2022-04-29 neomutt(1)