Ubuntu Manpage: claws-mail - a GTK+ based fast email and news client

NAME

       claws-mail - a GTK+ based fast email and news client

SYNOPSIS

       claws-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)
              • support for plugins

       This list is not complete.

OPTIONS

        --compose [address]
        --compose-from-file file
        --subscribe uri
        --attach file1 [file2]...
        --insert 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 directory
        --geometry WxH+X+Y

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/addrbook/attributesrc
              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/gtkrc-2.0
              Optional GTK+ settings to be load on startup.

       $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/passwordstorerc
              User saved passwords.

       $HOME/.claws-mail/tagsrc
              User-specified tag list.

       $HOME/.claws-mail/toolbar*.xml
              User-defined custom toolbars.

       %TEMP%\claws-win32.log
              (Windows only) 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.

       (Windows only) %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 the 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.

       --insert file1 [file2]...
              Open composition window with specified files inserted.

       --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 destination 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 the 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 section).

       --toggle-debug
              Toggle debug mode of the 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 the [dir] directory.

       --geometry WxH+X+Y
              Set initial X geometry of main window.

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 directories.

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-2020 The Claws Mail team and Hiroyuki Yamamoto

       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 and Hiroyuki
           Yamamoto.