1 .TH "CLAWS MAIL" "1" "January 13, 2014" "The Claws Mail team" "User Manuals"
5 Claws Mail \- a GTK+ based fast email and news client
13 Claws Mail is an email client (and news reader) based on GTK+, running on the X Window System, and aiming for:
17 \[bu] Graceful, and sophisticated interface
19 \[bu] Easy configuration, intuitive operation
21 \[bu] Abundant features
24 Currently implemented features include:
27 \[bu] IMAP4rev1 support
29 \[bu] integrated NetNews client
31 \[bu] unlimited multiple account handling
37 \[bu] MIME (attachments)
39 \[bu] built\-in image view
41 \[bu] X\-Face and (colour) Face support
43 \[bu] multiple MH folder support
45 \[bu] mbox importing / exporting
47 \[bu] external editor support
49 \[bu] message queueing
51 \[bu] automatic mail checking
53 \[bu] draft message function
55 \[bu] template function
61 \[bu] XML\-based address book
63 \[bu] LDAP, vCard, and JPilot support
65 \[bu] newly arrived and unread message management
67 \[bu] Mew/Wanderlust\-like key bind
71 \[bu] APOP authentication support
73 \[bu] SMTP AUTH support
75 \[bu] SSL support (POP3, SMTP, IMAP4rev1)
79 \[bu] drag & drop (partially implemented)
83 \[bu] automake + autoconf support
85 \[bu] internationalization of UI messages by gettext
87 \[bu] support of many code sets, including UTF\-8 (Unicode) (when using libjconv)
89 \[bu] support for plugins
92 This list is not complete.
96 \fB \-\-compose\fR [address]
98 \fB \-\-compose\-from\-file\fR file
100 \fB \-\-subscribe\fR [uri]
102 \fB \-\-attach file1 [file2]...\fR
106 \fB \-\-receive\-all\fR
108 \fB \-\-cancel\-receiving\fR
110 \fB \-\-cancel\-sending\fR
116 \fB \-\-status folder[/subfolder]\fR
118 \fB \-\-status\-full\fR
120 \fB \-\-statistics\fR
122 \fB \-\-reset-statistics\fR
124 \fB \-\-select [#mh/mailbox/]folder[/msg|/msgid]\fR
134 \fB \-\-toggle\-debug\fR
140 \fB \-\-version\-full\fR
142 \fB \-\-config\-dir\fR
144 \fB \-\-alternate\-config\-dir [dir]\fR
150 Default directory for mail storage
152 $PREFIX/share/claws\-mail
153 Global program directory
155 $PREFIX/share/claws\-mail/manual
156 Manual files in HTML, PDF, PostScript and plain text format
158 $PREFIX/share/claws\-mail/themes
159 Global themes directory
161 $PREFIX/lib/claws\-mail/plugins
162 Directory for plugins
164 $PREFIX/include/claws\-mail
165 Directory for header files
168 Default directory for user's configuration files directory
170 $HOME/.claws\-mail/addrbook/*
173 $HOME/.claws\-mail/autofaces/*
174 Automatic Faces and X\-Faces files for accounts
176 $HOME/.claws\-mail/certs/*
177 SSL certificates received from mail servers
179 $HOME/.claws\-mail/templates
180 User\-defined templates directory
182 $HOME/.claws\-mail/themes
183 User's themes directory
185 $HOME/.claws\-mail/accountrc
186 Configuration for account(s)
188 $HOME/.claws\-mail/actionsrc
189 User\-defined custom actions
191 $HOME/.claws\-mail/addressbookcustomattributerc
192 User\-defined address book custom attributes
194 $HOME/.claws\-mail/claws.log
197 $HOME/.claws\-mail/claws-win32.log
198 Claws Mail output file (Windows only)
200 $HOME/.claws\-mail/clawsrc
201 Main configuration file
203 $HOME/.claws\-mail/command_history
204 User\-specified commands
206 $HOME/.claws\-mail/customheaderrc
207 Configuration for custom headers for sending mail
209 $HOME/.claws\-mail/dispheaderrc
210 Configuration for custom display of headers in message view
212 $HOME/.claws\-mail/extraheaderrc
213 Editable extra headers to be added to compose window combobox
215 $HOME/.claws\-mail/folderitemrc
216 All folders' attributes
218 $HOME/.claws\-mail/folderlist.xml
219 Folder hierarchy listing
221 $HOME/.claws\-mail/matcherrc
222 Filtering and Processing function configuration
224 $HOME/.claws\-mail/menurc
225 Menu shortcut\-key configuration
227 $HOME/.claws\-mail/messagesearch_history
228 User\-specified searches in message bodies
230 $HOME/.claws\-mail/quicksearch_history
231 User\-specified quick\-search list
233 $HOME/.claws\-mail/messagesearch_history
234 User\-specified searches in message bodies
236 $HOME/.claws\-mail/summary*_history
237 User\-specified searches in message list
239 $HOME/.claws\-mail/tagsrc
240 User\-specified tag list
242 $HOME/.claws\-mail/toolbar*.xml
243 User\-defined custom toolbars
247 To run this program the standard way type:
251 Alternatively you can run it with the following options:
253 \fB\-\-compose [address]\fR
254 to open a Compose window
256 \fB\-\-compose\-from\-file file
257 open composition window with data from given file. Use \- as file name
258 for reading from standard input. Content format: headers first (To:
259 header required) until an empty line is found, then mail body until
262 \fB\-\-subscribe [uri]\fR
263 subscribe to the given URI if possible
265 \fB\-\-attach file1 [file2]...\fR
266 open composition window with specified files attached
268 \fB\-\-compose\fR "mailto:\fI%t\fR?subject=\fI%s\fR&cc=\fI%c\fR&body=\fI%b\fR"
269 this syntax can be used in web\-browsers and CLI to open a pre\-populated Compose window.
270 Possible fields after the destination recipient are: subject, from, cc, bcc, in\-reply\-to,
271 body, insert (insert a file in body part, needs an absolute path), attach (attach a file,
272 needs an absolute path, see also: \-\-attach)
277 \fB\-\-receive\-all\fR
278 receive new messages from all accounts
280 \fB\-\-cancel\-receiving\fR
281 cancel receiving of messages
283 \fB\-\-cancel\-sending\fR
284 cancel sending of messages
288 send all queued messages
291 show the total number of messages
293 [new][unread][unread answers to marked][total]
295 \fB\-\-status folder[/subfolder]\fR
296 show the total number of messages in specified folder
298 [new][unread][unread answers to marked][total]
300 \fB\-\-status\-full\fR
301 show the total number of messages per folder
303 [new][unread][unread answers to marked][total]
307 show session statistics
309 \fB\-\-reset-statistics\fR
311 reset session statistics
313 \fB\-\-select [#mh/mailbox/]folder[/msg|/msgid]\fR
314 on startup, jumps to the specified folder/message
317 start Claws Mail in (or switch to, if already running) online mode
320 start Claws Mail in (or switch to, if already running) offline mode
323 display the help message and exit
331 \fB\-\-toggle-debug\fR
332 toggle debug mode of a running Claws Mail instance
335 display version number and exit
337 \fB\-\-version\-full\fR
338 display version number and compiled\-in features then exit
340 \fB\-\-config\-dir\fR
341 display the CONFIG\-DIR and exit
343 \fB\-\-alternate\-config\-dir [dir]\fR
344 start Claws Mail with the configuration stored in [dir] directory
350 if defined disables crash dialog (only if Claws Mail has been built with
351 crash dialog feature enabled)
354 default host and display number to use
357 the information to access the GPG agent if using GPG agent is enabled in
358 GPG plugin preferences (this is usually set by the agent when launched,
359 otherwise it likely means the GPG agent is not running)
361 \fBG_BROKEN_FILENAMES\fR
362 assumes that filenames are in the locale encoding rather than in UTF-8
365 full path of the user's home directory
367 \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLANG\fR
368 locale to use for non-win32 systems (the first one not empty is used)
371 if defined overrides default J-Pilot charset (CP1252)
373 \fBPOSIXLY_CORRECT\fR
374 if defined regular expressions matching follows POSIX standards
376 \fBSESSION_MANAGER\fR
377 if defined tries to use the Session Manager (only if Claws Mail has been
378 built with libSM feature enabled)
381 if defined overrides default shell "sh" used by Spamassassin plugin to
382 launch spamc wrappers
385 use this CA certificates directory instead known system directories
388 use this CA certificates file instead of searching known system files
391 used to initialize default "user_id" preference in newly created accounts
396 You can search for existing bugs and report new ones on Claws Mail bugzilla:
398 <http://www.thewildbeast.co.uk/claws-mail/bugzilla/>
403 1999-2014 Hiroyuki Yamamoto and the Claws Mail team
408 .I "The Claws Mail Team"
411 Holger Berndt <berndth@users.sf.net>
413 Tristan Chabredier <wwp@claws\-mail.org>
415 Andrej Kacian <andrej@kacian.sk>
417 Darko Koruga <darko@users.sf.net>
419 Ricardo Mones Lastra <ricardo@mones.org>
421 Colin Leroy <colin@colino.net>
423 Paul Mangan <paul@claws\-mail.org>
425 Salvatore De Paolis <iwkse@claws\-mail.org>
427 Pawel Pekala <cOrn@o2.pl>
429 Michael Rasmussen <mir@datanom.net>
433 .I "Previous team members"
436 Ho\(`a Vi\(^et Dinh, Keith Edmunds, Match Grun, Melvin Hadasht,
437 Oliver Haertel, Christoph Hohmann, Alfons Hoogervorst, Werner Koch,
438 Thorsten Maerz, Leandro A. F. Pereira, Luke Plant, Martin Schaaf,
439 Carsten Schurig, Fabien Vantard, Sergey Vlasov, Hiroyuki Yamamoto
446 <http://www.claws\-mail.org>
448 Claws Mail online manual
449 <http://www.claws\-mail.org/manual>
452 <http://www.claws\-mail.org/plugins.php>