1 .TH "CLAWS MAIL" "1" "March 26, 2017" "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
146 \fB \-\-geometry WxH+X+Y\fR
152 Default directory for mail storage.
154 $PREFIX/share/claws\-mail
155 Global program directory.
157 $PREFIX/share/claws\-mail/manual
158 Manual files in HTML, PDF, PostScript and plain text format.
160 $PREFIX/share/claws\-mail/themes
161 Global themes directory.
163 $PREFIX/lib/claws\-mail/plugins
164 Directory for plugins.
166 $PREFIX/include/claws\-mail
167 Directory for header files.
170 Default directory for user's configuration files directory.
172 $HOME/.claws\-mail/addrbook/*
175 $HOME/.claws\-mail/autofaces/*
176 Automatic Faces and X\-Faces files for accounts.
178 $HOME/.claws\-mail/certs/*
179 SSL certificates received from mail servers.
181 $HOME/.claws\-mail/tagsdb
184 $HOME/.claws\-mail/templates
185 User\-defined templates directory.
187 $HOME/.claws\-mail/themes
188 User's themes directory.
190 $HOME/.claws\-mail/accountrc
191 Configuration for account(s).
193 $HOME/.claws\-mail/actionsrc
194 User\-defined custom actions.
196 $HOME/.claws\-mail/addrbook/attributesrc
197 User\-defined address book custom attributes.
199 $HOME/.claws\-mail/claws.log
202 $HOME/.claws\-mail/clawsrc
203 Main configuration file.
205 $HOME/.claws\-mail/command_history
206 User\-specified commands.
208 $HOME/.claws\-mail/customheaderrc
209 Configuration for custom headers for sending mail.
211 $HOME/.claws\-mail/dispheaderrc
212 Configuration for custom display of headers in message view.
214 $HOME/.claws\-mail/extraheaderrc
215 Editable extra headers to be added to compose window combobox.
217 $HOME/.claws\-mail/folderitemrc
218 All folders' attributes.
220 $HOME/.claws\-mail/folderlist.xml
221 Folder hierarchy listing.
223 $HOME/.claws\-mail/gtkrc-2.0
224 Optional GTK+ settings to be load on startup.
226 $HOME/.claws\-mail/matcherrc
227 Filtering and Processing function configuration.
229 $HOME/.claws\-mail/menurc
230 Menu shortcut\-key configuration.
232 $HOME/.claws\-mail/messagesearch_history
233 User\-specified searches in message bodies.
235 $HOME/.claws\-mail/quicksearch_history
236 User\-specified quick\-search list.
238 $HOME/.claws\-mail/messagesearch_history
239 User\-specified searches in message bodies.
241 $HOME/.claws\-mail/summary*_history
242 User\-specified searches in message list.
244 $HOME/.claws\-mail/passwordstorerc
245 User saved passwords.
247 $HOME/.claws\-mail/tagsrc
248 User\-specified tag list.
250 $HOME/.claws\-mail/toolbar*.xml
251 User\-defined custom toolbars.
256 %TEMP%\\claws\-win32.log
257 Claws Mail output file when \-\-debug is enabled. If %TEMP% is not set it
258 defaults to windows directory (usually C:\\Windows) or C:\\ if windows
259 directory is not available.
261 %APPDATA%\\Claws\-mail\\claws.log
266 To run this program the standard way type:
270 Alternatively you can run it with the following options:
272 \fB\-\-compose [address]\fR
273 To open a Compose window.
275 \fB\-\-compose\-from\-file file
276 Open composition window with data from the given file. Use \- as file name
277 for reading from standard input. Content format: headers first (To: header
278 required) until an empty line is found, then mail body until end of file.
280 \fB\-\-subscribe [uri]\fR
281 Subscribe to the given URI if possible.
283 \fB\-\-attach file1 [file2]...\fR
284 Open composition window with specified files attached.
286 \fB\-\-compose\fR "mailto:\fI%t\fR?subject=\fI%s\fR&cc=\fI%c\fR&body=\fI%b\fR"
287 This syntax can be used in web\-browsers and CLI to open a pre\-populated
288 Compose window. Possible fields after the destination recipient are: subject,
289 from, cc, bcc, in\-reply\-to, body, insert (insert a file in body part, needs
290 an absolute path), attach (attach a file, needs an absolute path, see also:
294 Receive new messages.
296 \fB\-\-receive\-all\fR
297 Receive new messages from all accounts.
299 \fB\-\-cancel\-receiving\fR
300 Cancel receiving of messages.
302 \fB\-\-cancel\-sending\fR
303 Cancel sending of messages.
307 Send all queued messages.
310 Show the total number of messages:
312 [new][unread][unread answers to marked][total]
314 \fB\-\-status folder[/subfolder]\fR
315 Show the total number of messages in the specified folder:
317 [new][unread][unread answers to marked][total]
319 \fB\-\-status\-full\fR
320 Show the total number of messages per folder:
322 [new][unread][unread answers to marked][total]
326 Show session statistics.
328 \fB\-\-reset-statistics\fR
330 Reset session statistics.
332 \fB\-\-select [#mh/mailbox/]folder[/msg|/msgid]\fR
333 On startup, jumps to the specified folder/message.
336 Start Claws Mail in (or switch to, if already running) online mode.
339 Start Claws Mail in (or switch to, if already running) offline mode.
342 Display the help message and exit.
348 For debug mode (on Windows systems output is written to a file instead
349 of standard error output, see \fBWindows only\fR on \fBFILES\fR
352 \fB\-\-toggle-debug\fR
353 Toggle debug mode of the running Claws Mail instance.
356 Display version number and exit.
358 \fB\-\-version\-full\fR
359 Display version number and compiled\-in features then exit.
361 \fB\-\-config\-dir\fR
362 Display the CONFIG\-DIR and exit.
364 \fB\-\-alternate\-config\-dir [dir]\fR
365 Start Claws Mail with the configuration stored in the [dir] directory.
367 \fB\-\-geometry WxH+X+Y\fR
368 Set initial X geometry of main window.
374 If defined disables crash dialog (only if Claws Mail has been built with
375 crash dialog feature enabled).
378 Default host and display number to use.
380 \fBETPANSERVER\fR, \fBETPANPORT\fR
381 When using a tunnel command to open server connections these temporary
382 variables are set to the server name and server port respectively in the
383 environment of the running command.
386 The information to access the GPG agent if using GPG agent is enabled in
387 GPG plugin preferences (this is usually set by the agent when launched,
388 otherwise it likely means the GPG agent is not running).
390 \fBG_BROKEN_FILENAMES\fR
391 Assumes that filenames are in the locale encoding rather than in UTF\-8.
394 Full path of the user's home directory.
396 \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLANG\fR
397 Locale to use for non\-windows systems (the first one not empty is used).
400 If defined overrides default J\-Pilot charset (CP1252).
402 \fBPOSIXLY_CORRECT\fR
403 If defined regular expressions matching follows POSIX standards.
405 \fBSESSION_MANAGER\fR
406 If defined tries to use the Session Manager (only if Claws Mail has been
407 built with libSM feature enabled).
410 If defined overrides default shell "sh" used by Spamassassin plugin to
411 launch spamc wrappers.
414 Use this CA certificates directory instead known system directories.
417 Use this CA certificates file instead of searching known system files.
420 Used to initialize default "user_id" preference in newly created accounts.
425 You can search for existing bugs and report new ones on Claws Mail bugzilla:
427 <http://www.thewildbeast.co.uk/claws\-mail/bugzilla/>
432 1999\-2017 The Claws Mail team and Hiroyuki Yamamoto
434 Portions are also Copyright:
436 (C) 2007\-2009 g10 Code GmbH
438 (C) 1999\-2005 Nullsoft, Inc.
440 (C) 1991\-1993, 1996\-2000, 2001 Free Software Foundation, Inc.
442 (C) 2001 Thomas Link, Hiroyuki Yamamoto
444 (C) 1995\-1997 Peter Mattis and Spencer Kimball
446 (C) 1995\-1997 Peter Mattis, Spencer Kimball, Josh MacDonald
448 (C) 1997\-1998 Jay Painter <jpaint@serv.net><jpaint@gimp.org>
450 (C) 1999\-2003 Michael Natterer <mitch@gimp.org>
454 (C) 1998 Lars Hamann and Stefan Jeske
456 (C) 2005, 2006, 2007, 2009 GNOME Foundation
458 (C) 2004\-2006 Christian Hammond
460 (C) 2003\-2004 Pawel Salek
462 (C) 2001, 2002 \- DINH Viet Hoa
464 (C) 1999\-2000, Gael Roualland <gael.roualland@iname.com>
466 (C) 1998\-2002 Sendmail, Inc.
468 (C) 2007\-2008 Juha Kautto (juha at xfce.org)
470 (C) 1994\-2002 World Wide Web Consortium
472 (C) 1999 Graham Davison
474 (C) 1999 Eric Busboom
476 (C) 2000, Eric Busboom, http://www.softwarestudio.org
478 (C) 2002\-2007 Randall Hand <yerase@yerot.com>
480 (C) 2001 by Werner Koch <dd9jn@gnu.org>
482 (C) 2004 Apache Software Foundation
484 (C) 2008 Mikkel Kamstrup Erlandsen
486 (C) 2002 Red Hat, Inc.; Copyright 1998, 2001 Tim Janik
488 (C) 2008\-2009 Christian Hammond, David Trowbridge
490 (C) 2003\-2005 Lars Lindner <lars.lindner@gmx.net>
492 (C) 2004,2005 Nathan J. Conrad <t98502@users.sourceforge.net>
494 (C) 2004 Karl Soderstrom <ks@xanadunet.net>
496 (C) 2000 Helix Code, Inc. (www.helixcode.com)
501 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.
503 See COPYING file on toplevel distribution directory for more license details.
508 .I "The Claws Mail Team"
511 Holger Berndt <berndth@users.sf.net>
513 Tristan Chabredier <wwp@claws\-mail.org>
515 Andrej Kacian <andrej@kacian.sk>
517 Darko Koruga <darko@users.sf.net>
519 Ricardo Mones Lastra <ricardo@mones.org>
521 Charles Lehner <charles@claws-mail.org>
523 Colin Leroy <colin@colino.net>
525 Paul Mangan <paul@claws\-mail.org>
527 Salvatore De Paolis <iwkse@claws\-mail.org>
529 Pawel Pekala <cOrn@o2.pl>
531 Michael Rasmussen <mir@datanom.net>
535 .I "Previous team members"
538 Ho\(`a Vi\(^et Dinh, Keith Edmunds, Match Grun, Melvin Hadasht,
539 Oliver Haertel, Christoph Hohmann, Alfons Hoogervorst, Werner Koch,
540 Thorsten Maerz, Leandro A. F. Pereira, Luke Plant, Martin Schaaf,
541 Carsten Schurig, Fabien Vantard, Sergey Vlasov and Hiroyuki Yamamoto.
548 <http://www.claws\-mail.org>
550 Claws Mail frequently asked questions
551 <http://www.claws\-mail.org/faq>
553 Claws Mail online manual
554 <http://www.claws\-mail.org/manual>
557 <http://www.claws\-mail.org/plugins.php>
559 \fIX\fR(7), \fIxwininfo\fR(1).