CLAWS MAIL(1) User Manuals CLAWS MAIL(1)NAME
Claws Mail - a GTK+ based fast email and news client
SYNOPSISclaws-mail [options]
DESCRIPTION
Claws Mail is an email client (and news reader) based on GTK+, running
on the X Window System, and aiming for:
· Quick response
· Graceful, and sophisticated interface
· Easy configuration, intuitive operation
· Abundant features
Currently implemented features include:
· POP3 support
· IMAP4rev1 support
· integrated NetNews client
· unlimited multiple account handling
· thread display
· filtering
· MIME (attachments)
· built-in image view
· X-Face and (colour) Face support
· multiple MH folder support
· mbox importing / exporting
· external editor support
· message queueing
· automatic mail checking
· draft message function
· template function
· line-wrapping
· clickable URI
· XML-based address book
· LDAP, vCard, and JPilot support
· newly arrived and unread message management
· Mew/Wanderlust-like key bind
· printing
· APOP authentication support
· SMTP AUTH support
· SSL support (POP3, SMTP, IMAP4rev1)
· IPv6 support
· drag & drop (partially implemented)
· GnuPG support
· automake + autoconf support
· internationalization of UI messages by gettext
· support of many code sets, including UTF-8 (Unicode) (when
using libjconv)
· support for plugins
This list is not complete.
OPTIONS--compose [address]
--compose-from-file file
--subscribe [uri]
--attach file1 [file2]...
--receive
--receive-all
--cancel-receiving
--cancel-sending
--send
--status
--status folder[/subfolder]
--status-full
--statistics
--reset-statistics
--select [#mh/mailbox/]folder[/msg|/msgid]
--online
--offline
--exit
--debug
--toggle-debug
--help
--version
--version-full
--config-dir
--alternate-config-dir [dir]
FILES
$HOME/Mail
Default directory for mail storage
$PREFIX/share/claws-mail
Global program directory
$PREFIX/share/claws-mail/manual
Manual files in HTML, PDF, PostScript and plain text format
$PREFIX/share/claws-mail/themes
Global themes directory
$PREFIX/lib/claws-mail/plugins
Directory for plugins
$PREFIX/include/claws-mail
Directory for header files
$HOME/.claws-mail
Default directory for user's configuration files directory
$HOME/.claws-mail/addrbook/*
Addressbook files
$HOME/.claws-mail/autofaces/*
Automatic Faces and X-Faces files for accounts
$HOME/.claws-mail/certs/*
SSL certificates received from mail servers
$HOME/.claws-mail/tagsdb
Tags directory
$HOME/.claws-mail/templates
User-defined templates directory
$HOME/.claws-mail/themes
User's themes directory
$HOME/.claws-mail/accountrc
Configuration for account(s)
$HOME/.claws-mail/actionsrc
User-defined custom actions
$HOME/.claws-mail/addressbookcustomattributerc
User-defined address book custom attributes
$HOME/.claws-mail/claws.log
Claws Mail logfile
$HOME/.claws-mail/clawsrc
Main configuration file
$HOME/.claws-mail/command_history
User-specified commands
$HOME/.claws-mail/customheaderrc
Configuration for custom headers for sending mail
$HOME/.claws-mail/dispheaderrc
Configuration for custom display of headers in message view
$HOME/.claws-mail/extraheaderrc
Editable extra headers to be added to compose window combobox
$HOME/.claws-mail/folderitemrc
All folders' attributes
$HOME/.claws-mail/folderlist.xml
Folder hierarchy listing
$HOME/.claws-mail/matcherrc
Filtering and Processing function configuration
$HOME/.claws-mail/menurc
Menu shortcut-key configuration
$HOME/.claws-mail/messagesearch_history
User-specified searches in message bodies
$HOME/.claws-mail/quicksearch_history
User-specified quick-search list
$HOME/.claws-mail/messagesearch_history
User-specified searches in message bodies
$HOME/.claws-mail/summary*_history
User-specified searches in message list
$HOME/.claws-mail/tagsrc
User-specified tag list
$HOME/.claws-mail/toolbar*.xml
User-defined custom toolbars
Windows only
%TEMP%\claws-win32.log
Claws Mail output file when --debug is enabled. If %TEMP% is not
set it defaults to windows directory (usually C:\Windows) or C:\
if windows directory is not available.
%APPDATA%\Claws-mail\claws.log
Claws Mail log file
EXAMPLES
To run this program the standard way type:
claws-mail
Alternatively you can run it with the following options:
--compose [address]
to open a Compose window
--compose-from-file file
open composition window with data from given file. Use - as file
name for reading from standard input. Content format: headers
first (To: header required) until an empty line is found, then
mail body until end of file.
--subscribe [uri]
subscribe to the given URI if possible
--attach file1 [file2]...
open composition window with specified files attached
--compose "mailto:%t?subject=%s&cc=%c&body=%b"
this syntax can be used in web-browsers and CLI to open a
pre-populated Compose window. Possible fields after the desti‐
nation recipient are: subject, from, cc, bcc, in-reply-to, body,
insert (insert a file in body part, needs an absolute path),
attach (attach a file, needs an absolute path, see also:
--attach)
--receive
receive new messages
--receive-all
receive new messages from all accounts
--cancel-receiving
cancel receiving of messages
--cancel-sending
cancel sending of messages
--send
send all queued messages
--status
show the total number of messages
[new][unread][unread answers to marked][total]
--status folder[/subfolder]
show the total number of messages in specified folder
[new][unread][unread answers to marked][total]
--status-full
show the total number of messages per folder
[new][unread][unread answers to marked][total]
--statistics
show session statistics
--reset-statistics
reset session statistics
--select [#mh/mailbox/]folder[/msg|/msgid]
on startup, jumps to the specified folder/message
--online
start Claws Mail in (or switch to, if already running) online
mode
--offline
start Claws Mail in (or switch to, if already running) offline
mode
--help display the help message and exit
--exit exit Claws Mail
--debug
for debug mode (on Windows systems output is written to a file
instead of standard error output, see Windows only on FILES sec‐
tion)
--toggle-debug
toggle debug mode of a running Claws Mail instance
--version
display version number and exit
--version-full
display version number and compiled-in features then exit
--config-dir
display the CONFIG-DIR and exit
--alternate-config-dir [dir]
start Claws Mail with the configuration stored in [dir] direc‐
tory
ENVIRONMENT
CLAWS_NO_CRASH
if defined disables crash dialog (only if Claws Mail has been
built with crash dialog feature enabled)
DISPLAY
default host and display number to use
ETPANSERVER, ETPANPORT
when using a tunnel command to open server connections these
temporary variables are set to the server name and server port
respectively in the environment of the running command
GPG_AGENT_INFO
the information to access the GPG agent if using GPG agent is
enabled in GPG plugin preferences (this is usually set by the
agent when launched, otherwise it likely means the GPG agent is
not running)
G_BROKEN_FILENAMES
assumes that filenames are in the locale encoding rather than in
UTF-8
HOME full path of the user's home directory
LC_ALL, LC_CTYPE, LANG
locale to use for non-windows systems (the first one not empty
is used)
PILOT_CHARSET
if defined overrides default J-Pilot charset (CP1252)
POSIXLY_CORRECT
if defined regular expressions matching follows POSIX standards
SESSION_MANAGER
if defined tries to use the Session Manager (only if Claws Mail
has been built with libSM feature enabled)
SHELL if defined overrides default shell "sh" used by Spamassassin
plugin to launch spamc wrappers
SSL_CERT_DIR
use this CA certificates directory instead known system directo‐
ries
SSL_CERT_FILE
use this CA certificates file instead of searching known system
files
USER used to initialize default "user_id" preference in newly created
accounts
BUGS
You can search for existing bugs and report new ones on Claws Mail
bugzilla:
<http://www.thewildbeast.co.uk/claws-mail/bugzilla/>
COPYRIGHT
1999-2015 Hiroyuki Yamamoto and the Claws Mail team
Portions are also Copyright:
(C) 2007-2009 g10 Code GmbH
(C) 1999-2005 Nullsoft, Inc.
(C) 1991-1993, 1996-2000, 2001 Free Software Foundation, Inc.
(C) 2001 Thomas Link, Hiroyuki Yamamoto
(C) 1995-1997 Peter Mattis and Spencer Kimball
(C) 1995-1997 Peter Mattis, Spencer Kimball, Josh MacDonald
(C) 1997-1998 Jay Painter <jpaint@serv.net><jpaint@gimp.org>
(C) 1999-2003 Michael Natterer <mitch@gimp.org>
(C) 2000 Evan Martin
(C) 1998 Lars Hamann and Stefan Jeske
(C) 2005, 2006, 2007, 2009 GNOME Foundation
(C) 2004-2006 Christian Hammond
(C) 2003-2004 Pawel Salek
(C) 2001, 2002 - DINH Viet Hoa
(C) 1999-2000, Gael Roualland <gael.roualland@iname.com>
(C) 1998-2002 Sendmail, Inc.
(C) 2007-2008 Juha Kautto (juha at xfce.org)
(C) 1994-2002 World Wide Web Consortium
(C) 1999 Graham Davison
(C) 1999 Eric Busboom
(C) 2000, Eric Busboom, http://www.softwarestudio.org
(C) 2002-2007 Randall Hand <yerase@yerot.com>
(C) 2001 by Werner Koch <dd9jn@gnu.org>
(C) 2004 Apache Software Foundation
(C) 2008 Mikkel Kamstrup Erlandsen
(C) 2002 Red Hat, Inc.; Copyright 1998, 2001 Tim Janik
(C) 2008-2009 Christian Hammond, David Trowbridge
(C) 2003-2005 Lars Lindner <lars.lindner@gmx.net>
(C) 2004,2005 Nathan J. Conrad <t98502@users.sourceforge.net>
(C) 2004 Karl Soderstrom <ks@xanadunet.net>
(C) 2000 Helix Code, Inc. (www.helixcode.com)
LICENSE
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.
See COPYING file on toplevel distribution directory for more license
details.
AUTHORS
The Claws Mail Team
Holger Berndt <berndth@users.sf.net>
Tristan Chabredier <wwp@claws-mail.org>
Andrej Kacian <andrej@kacian.sk>
Darko Koruga <darko@users.sf.net>
Ricardo Mones Lastra <ricardo@mones.org>
Charles Lehner <charles@claws-mail.org>
Colin Leroy <colin@colino.net>
Paul Mangan <paul@claws-mail.org>
Salvatore De Paolis <iwkse@claws-mail.org>
Pawel Pekala <cOrn@o2.pl>
Michael Rasmussen <mir@datanom.net>
Previous team members
Hoà Viêt Dinh, Keith Edmunds, Match Grun, Melvin Hadasht, Oliver
Haertel, Christoph Hohmann, Alfons Hoogervorst, Werner Koch,
Thorsten Maerz, Leandro A. F. Pereira, Luke Plant, Martin Schaaf,
Carsten Schurig, Fabien Vantard, Sergey Vlasov, Hiroyuki Yamamoto
SEE ALSO
Claws Mail Homepage
<http://www.claws-mail.org>
Claws Mail frequently asked questions
<http://www.claws-mail.org/faq>
Claws Mail online manual
<http://www.claws-mail.org/manual>
Claws Mail plugins
<http://www.claws-mail.org/plugins.php>
The Claws Mail team June 4, 2015 CLAWS MAIL(1)