claws-mail(1)

1Claws Mail(1)               General Commands Manual              Claws Mail(1)
2
3
4

NAME

6       Claws Mail - a GTK+ based fast email and news client
7
8

SYNOPSIS

10       claws-mail [options]
11
12

DESCRIPTION

14       Claws  Mail is an email client (and news reader) based on GTK+, running
15       on X Window System, and aiming for
16              * Quick response
17              * Graceful, and sophisticated interface
18              * Easy configuration, intuitive operation
19              * Abundant features
20
21       Currently implemented features include:
22              o POP3 support
23              o IMAP4rev1 support
24              o integrated NetNews client
25              o unlimited multiple account handling
26              o thread display
27              o filtering
28              o MIME (attachments)
29              o built-in image view
30              o X-Face and (colour) Face support
31              o multiple MH folder support
32              o mbox importing / exporting
33              o external editor support
34              o message queueing
35              o automatic mail checking
36              o draft message function
37              o template function
38              o line-wrapping
39              o clickable URI
40              o XML-based address book
41              o LDAP, vCard, and JPilot support
42              o newly arrived and unread message management
43              o Mew/Wanderlust-like key bind
44              o printing
45              o APOP authentication support
46              o SMTP AUTH support
47              o SSL support (POP3, SMTP, IMAP4rev1)
48              o IPv6 support
49              o drag & drop (partially implemented)
50              o GnuPG support
51              o automake + autoconf support
52              o internationalization of messages by gettext
53              o support of many code sets,  including  UTF-8  (Unicode)  (when
54              using libjconv)
55              o support for plugins
56
57       This list is not complete.
58
59

OPTIONS

61        --compose [address]
62        --subscribe [uri]
63        --attach file1 [file2]...
64        --receive
65        --receive-all
66        --send
67        --status
68        --status folder[/subfolder]
69        --status-full
70        --select [#mh/mailbox/]folder[/msg|/msgid]
71        --online
72        --offline
73        --exit
74        --debug
75        --help
76        --version
77        --version-full
78        --config-dir
79        --alternate-config-dir [dir]
80
81

FILES

83       $HOME/Mail
84              Default directory for mail storage
85
86       $PREFIX/share/claws-mail
87              Global program directory
88
89       $PREFIX/share/claws-mail/manual
90              Manual files in HTML, PDF, PostScript and plain text format
91
92       $PREFIX/share/claws-mail/themes
93              Global themes directory
94
95       $PREFIX/lib/claws-mail/plugins
96              Directory for plugins
97
98       $PREFIX/include/claws-mail
99              Directory for header files
100
101       $HOME/.claws-mail
102              Default directory for user's configuration files directory
103
104       $HOME/.claws-mail/addrbook/*
105              Addressbook files
106
107       $HOME/.claws-mail/templates
108              User-defined templates directory
109
110       $HOME/.claws-mail/themes
111              User's themes directory
112
113       $HOME/.claws-mail/accountrc
114              Configuration for account(s)
115
116       $HOME/.claws-mail/actionsrc
117              User-defined custom actions
118
119       $HOME/.claws-mail/addressbookcustomattributerc
120              User-defined address book custom attributes
121
122       $HOME/.claws-mail/claws.log
123              Claws Mail logfile
124
125       $HOME/.claws-mail/claws-win32.log
126              Claws Mail output file (Windows only)
127
128       $HOME/.claws-mail/clawsrc
129              Main configuration file
130
131       $HOME/.claws-mail/command_history
132              User-specified commands
133
134       $HOME/.claws-mail/customheaderrc
135              Configuration for custom headers for sending mail
136
137       $HOME/.claws-mail/dispheaderrc
138              Configuration for custom display of headers in message view
139
140       $HOME/.claws-mail/folderitemrc
141              All folders' attributes
142
143       $HOME/.claws-mail/folderlist.xml
144              Folder hierarchy listing
145
146       $HOME/.claws-mail/matcherrc
147              Filtering and Processing function configuration
148
149       $HOME/.claws-mail/menurc
150              Menu shortcut-key configuration
151
152       $HOME/.claws-mail/messagesearch_history
153              User-specified searches in message bodies
154
155       $HOME/.claws-mail/quicksearch_history
156              User-specified quick-search list
157
158       $HOME/.claws-mail/messagesearch_history
159              User-specified searches in message bodies
160
161       $HOME/.claws-mail/summary*_history
162              User-specified searches in message list
163
164       $HOME/.claws-mail/tagsrc
165              User-specified tag list
166
167       $HOME/.claws-mail/toolbar*.xml
168              User-defined custom toolbars
169
170

EXAMPLES

172       To run this program the standard way type:
173
174       claws-mail
175
176       Alternatively you can run it with the following options:
177
178       --compose [address]
179              to open a Compose window
180
181       --subscribe [uri]
182              subscribe to the given URI if possible
183
184       --attach file1 [file2]...
185              open composition window with specified files attached
186
187       --compose "mailto:%t?subject=%s&cc=%c&body=%b"
188              this  syntax  can  be  used  in  web-browsers  and CLI to open a
189              pre-populated Compose window.  Possible fields after the  desti‐
190              nation recipient are: subject, from, cc, bcc, in-reply-to, body,
191              insert (insert a file in body part,  needs  an  absolute  path),
192              attach  (attach  a  file,  needs  an  absolute  path,  see also:
193              --attach)
194
195       --receive
196              receive new messages
197
198       --receive-all
199              receive new messages from all accounts
200
201       --send
202              send all queued messages
203
204       --status
205              show the total number of messages
206              [new][unread][unread answers to marked][total]
207
208       --status folder[/subfolder]
209              show the total number of messages in specified folder
210              [new][unread][unread answers to marked][total]
211
212       --status-full
213              show the total number of messages per folder
214              [new][unread][unread answers to marked][total]
215
216       --select [#mh/mailbox/]folder[/msg|/msgid]
217              On startup, jumps to the specified folder/message
218
219       --online
220              Start claws-mail in (or switch to, if  already  running)  online
221              mode
222
223       --offline
224              Start  claws-mail  in (or switch to, if already running) offline
225              mode
226
227       --help display the help message and exit
228
229       --exit exit Claws Mail
230
231       --debug
232              for debug mode
233
234       --version
235              display version number and exit
236
237       --version-full
238              display version number and compiled-in features then exit
239
240       --config-dir
241              display the CONFIG-DIR and exit
242
243       --alternate-config-dir [dir]
244              start Claws Mail with the configuration stored in  [dir]  direc‐
245              tory
246
247

INSTALLATION

249       This program requires GTK+ 2.6.x or higher to be compiled.
250
251       Please  make  sure  that gtk-devel and glib-devel (or similar) packages
252       are installed before the compilation (you may also require  flex  (lex)
253       and bison (yacc)).
254
255       To compile and install, just type:
256
257       % ./configure
258       % make
259       % su
260       Password: [Enter password]
261       # make install
262
263       Refer to ./configure --help for further information.
264
265

AUTHORS

267       The Claws Mail Team
268              Holger Berndt            <berndth@users.sf.net>
269              Tristan Chabredier       <wwp@claws-mail.org>
270              Hoà Viêt Dinh            <hoa@users.sf.net>
271              Andrej Kacian            <andrej@kacian.sk>
272              Darko Koruga             <darko@users.sf.net>
273              Ricardo Mones Lastra     <ricardo@mones.org>
274              Colin Leroy              <colin@colino.net>
275              Paul Mangan              <paul@claws-mail.org>
276              Salvatore De Paolis      <iwkse@claws-mail.org>
277
278
279       Previous team members
280              Keith Edmunds
281              Match Grun
282              Melvin Hadasht
283              Oliver Haertel
284              Christoph Hohmann
285              Alfons Hoogervorst
286              Werner Koch
287              Thorsten Maerz
288              Leandro A. F. Pereira
289              Luke Plant
290              Martin Schaaf
291              Carsten Schurig
292              Fabien Vantard
293              Sergey Vlasov
294              Hiroyuki Yamamoto
295
296