other versions
- jessie 3.11.1-3+deb8u1
- jessie-backports 3.14.1-1~bpo8+1
- stretch 3.14.1-3+b1
- testing 3.17.2-1
- stretch-backports 3.17.1-1~bpo9+1
- unstable 3.17.3-1
CLAWS MAIL(1) | User Manuals | CLAWS MAIL(1) |
NAME¶
claws-mail - a GTK+ based fast email and news clientSYNOPSIS¶
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:
-
- Currently implemented features include:
- • POP3 support
OPTIONS¶
--compose [address]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/passwordstorerc
- User saved passwords
- $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 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
-
- --status
- show the total number of messages
- --status folder[/subfolder]
- show the total number of messages in specified folder
- --status-full
- show the total number of messages per folder
- --statistics
-
- --reset-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 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] 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:
-
COPYRIGHT¶
- 1999-2016 The Claws Mail team and Hiroyuki Yamamoto
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>
- X(7), xwininfo(1).
August 5, 2016 | The Claws Mail team |