1 .TH "CLAWS MAIL" "1" "June 4, 2015" "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/clawsrc
198 Main configuration file
200 $HOME/.claws\-mail/command_history
201 User\-specified commands
203 $HOME/.claws\-mail/customheaderrc
204 Configuration for custom headers for sending mail
206 $HOME/.claws\-mail/dispheaderrc
207 Configuration for custom display of headers in message view
209 $HOME/.claws\-mail/extraheaderrc
210 Editable extra headers to be added to compose window combobox
212 $HOME/.claws\-mail/folderitemrc
213 All folders' attributes
215 $HOME/.claws\-mail/folderlist.xml
216 Folder hierarchy listing
218 $HOME/.claws\-mail/matcherrc
219 Filtering and Processing function configuration
221 $HOME/.claws\-mail/menurc
222 Menu shortcut\-key configuration
224 $HOME/.claws\-mail/messagesearch_history
225 User\-specified searches in message bodies
227 $HOME/.claws\-mail/quicksearch_history
228 User\-specified quick\-search list
230 $HOME/.claws\-mail/messagesearch_history
231 User\-specified searches in message bodies
233 $HOME/.claws\-mail/summary*_history
234 User\-specified searches in message list
236 $HOME/.claws\-mail/tagsrc
237 User\-specified tag list
239 $HOME/.claws\-mail/toolbar*.xml
240 User\-defined custom toolbars
245 %TEMP%\\claws\-win32.log
246 Claws Mail output file when \-\-debug is enabled. If %TEMP% is not set it
247 defaults to windows directory (usually C:\\Windows) or C:\\ if windows
248 directory is not available.
250 %APPDATA%\\Claws\-mail\\claws.log
255 To run this program the standard way type:
259 Alternatively you can run it with the following options:
261 \fB\-\-compose [address]\fR
262 to open a Compose window
264 \fB\-\-compose\-from\-file file
265 open composition window with data from given file. Use \- as file name
266 for reading from standard input. Content format: headers first (To:
267 header required) until an empty line is found, then mail body until
270 \fB\-\-subscribe [uri]\fR
271 subscribe to the given URI if possible
273 \fB\-\-attach file1 [file2]...\fR
274 open composition window with specified files attached
276 \fB\-\-compose\fR "mailto:\fI%t\fR?subject=\fI%s\fR&cc=\fI%c\fR&body=\fI%b\fR"
277 this syntax can be used in web\-browsers and CLI to open a pre\-populated Compose window.
278 Possible fields after the destination recipient are: subject, from, cc, bcc, in\-reply\-to,
279 body, insert (insert a file in body part, needs an absolute path), attach (attach a file,
280 needs an absolute path, see also: \-\-attach)
285 \fB\-\-receive\-all\fR
286 receive new messages from all accounts
288 \fB\-\-cancel\-receiving\fR
289 cancel receiving of messages
291 \fB\-\-cancel\-sending\fR
292 cancel sending of messages
296 send all queued messages
299 show the total number of messages
301 [new][unread][unread answers to marked][total]
303 \fB\-\-status folder[/subfolder]\fR
304 show the total number of messages in specified folder
306 [new][unread][unread answers to marked][total]
308 \fB\-\-status\-full\fR
309 show the total number of messages per folder
311 [new][unread][unread answers to marked][total]
315 show session statistics
317 \fB\-\-reset-statistics\fR
319 reset session statistics
321 \fB\-\-select [#mh/mailbox/]folder[/msg|/msgid]\fR
322 on startup, jumps to the specified folder/message
325 start Claws Mail in (or switch to, if already running) online mode
328 start Claws Mail in (or switch to, if already running) offline mode
331 display the help message and exit
337 for debug mode (on Windows systems output is written to a file instead
338 of standard error output, see \fBWindows only\fR on \fBFILES\fR
341 \fB\-\-toggle-debug\fR
342 toggle debug mode of a running Claws Mail instance
345 display version number and exit
347 \fB\-\-version\-full\fR
348 display version number and compiled\-in features then exit
350 \fB\-\-config\-dir\fR
351 display the CONFIG\-DIR and exit
353 \fB\-\-alternate\-config\-dir [dir]\fR
354 start Claws Mail with the configuration stored in [dir] directory
360 if defined disables crash dialog (only if Claws Mail has been built with
361 crash dialog feature enabled)
364 default host and display number to use
367 the information to access the GPG agent if using GPG agent is enabled in
368 GPG plugin preferences (this is usually set by the agent when launched,
369 otherwise it likely means the GPG agent is not running)
371 \fBG_BROKEN_FILENAMES\fR
372 assumes that filenames are in the locale encoding rather than in UTF\-8
375 full path of the user's home directory
377 \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLANG\fR
378 locale to use for non\-windows systems (the first one not empty is used)
381 if defined overrides default J\-Pilot charset (CP1252)
383 \fBPOSIXLY_CORRECT\fR
384 if defined regular expressions matching follows POSIX standards
386 \fBSESSION_MANAGER\fR
387 if defined tries to use the Session Manager (only if Claws Mail has been
388 built with libSM feature enabled)
391 if defined overrides default shell "sh" used by Spamassassin plugin to
392 launch spamc wrappers
395 use this CA certificates directory instead known system directories
398 use this CA certificates file instead of searching known system files
401 used to initialize default "user_id" preference in newly created accounts
406 You can search for existing bugs and report new ones on Claws Mail bugzilla:
408 <http://www.thewildbeast.co.uk/claws\-mail/bugzilla/>
413 1999\-2015 Hiroyuki Yamamoto and the Claws Mail team
415 Portions are also Copyright:
417 (C) 2007\-2009 g10 Code GmbH
419 (C) 1999\-2005 Nullsoft, Inc.
421 (C) 1991\-1993, 1996\-2000, 2001 Free Software Foundation, Inc.
423 (C) 2001 Thomas Link, Hiroyuki Yamamoto
425 (C) 1995\-1997 Peter Mattis and Spencer Kimball
427 (C) 1995\-1997 Peter Mattis, Spencer Kimball, Josh MacDonald
429 (C) 1997\-1998 Jay Painter <jpaint@serv.net><jpaint@gimp.org>
431 (C) 1999\-2003 Michael Natterer <mitch@gimp.org>
435 (C) 1998 Lars Hamann and Stefan Jeske
437 (C) 2005, 2006, 2007, 2009 GNOME Foundation
439 (C) 2004\-2006 Christian Hammond
441 (C) 2003\-2004 Pawel Salek
443 (C) 2001, 2002 \- DINH Viet Hoa
445 (C) 1999\-2000, Gael Roualland <gael.roualland@iname.com>
447 (C) 1998\-2002 Sendmail, Inc.
449 (C) 2007\-2008 Juha Kautto (juha at xfce.org)
451 (C) 1994\-2002 World Wide Web Consortium
453 (C) 1999 Graham Davison
455 (C) 1999 Eric Busboom
457 (C) 2000, Eric Busboom, http://www.softwarestudio.org
459 (C) 2002\-2007 Randall Hand <yerase@yerot.com>
461 (C) 2001 by Werner Koch <dd9jn@gnu.org>
463 (C) 2004 Apache Software Foundation
465 (C) 2008 Mikkel Kamstrup Erlandsen
467 (C) 2002 Red Hat, Inc.; Copyright 1998, 2001 Tim Janik
469 (C) 2008\-2009 Christian Hammond, David Trowbridge
471 (C) 2003\-2005 Lars Lindner <lars.lindner@gmx.net>
473 (C) 2004,2005 Nathan J. Conrad <t98502@users.sourceforge.net>
475 (C) 2004 Karl Soderstrom <ks@xanadunet.net>
477 (C) 2000 Helix Code, Inc. (www.helixcode.com)
482 This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
484 See COPYING file on toplevel distribution directory for more license details.
489 .I "The Claws Mail Team"
492 Holger Berndt <berndth@users.sf.net>
494 Tristan Chabredier <wwp@claws\-mail.org>
496 Andrej Kacian <andrej@kacian.sk>
498 Darko Koruga <darko@users.sf.net>
500 Ricardo Mones Lastra <ricardo@mones.org>
502 Colin Leroy <colin@colino.net>
504 Paul Mangan <paul@claws\-mail.org>
506 Salvatore De Paolis <iwkse@claws\-mail.org>
508 Pawel Pekala <cOrn@o2.pl>
510 Michael Rasmussen <mir@datanom.net>
514 .I "Previous team members"
517 Ho\(`a Vi\(^et Dinh, Keith Edmunds, Match Grun, Melvin Hadasht,
518 Oliver Haertel, Christoph Hohmann, Alfons Hoogervorst, Werner Koch,
519 Thorsten Maerz, Leandro A. F. Pereira, Luke Plant, Martin Schaaf,
520 Carsten Schurig, Fabien Vantard, Sergey Vlasov, Hiroyuki Yamamoto
527 <http://www.claws\-mail.org>
529 Claws Mail online manual
530 <http://www.claws\-mail.org/manual>
533 <http://www.claws\-mail.org/plugins.php>