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
190
191       --receive
192              receive new messages
193
194       --receive-all
195              receive new messages from all accounts
196
197       --send
198              send all queued messages
199
200       --status
201              show the total number of messages
202              [new][unread][unread answers to marked][total]
203
204       --status folder[/subfolder]
205              show the total number of messages in specified folder
206              [new][unread][unread answers to marked][total]
207
208       --status-full
209              show the total number of messages per folder
210              [new][unread][unread answers to marked][total]
211
212       --select [#mh/mailbox/]folder[/msg|/msgid]
213              On startup, jumps to the specified folder/message
214
215       --online
216              Start claws-mail in (or switch to, if  already  running)  online
217              mode
218
219       --offline
220              Start  claws-mail  in (or switch to, if already running) offline
221              mode
222
223       --help display the help message and exit
224
225       --exit exit Claws Mail
226
227       --debug
228              for debug mode
229
230       --version
231              display version number and exit
232
233       --version-full
234              display version number and compiled-in features then exit
235
236       --config-dir
237              display the CONFIG-DIR and exit
238
239       --alternate-config-dir [dir]
240              start Claws Mail with the configuration stored in  [dir]  direc‐
241              tory
242
243

INSTALLATION

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

AUTHORS

263       The Claws Mail Team
264              Holger Berndt            <berndth@users.sf.net>
265              Tristan Chabredier       <wwp@claws-mail.org>
266              Hoà Viêt Dinh            <hoa@users.sf.net>
267              Werner Koch              <wk@gnupg.org>
268              Darko Koruga             <darko@users.sf.net>
269              Ricardo Mones Lastra     <ricardo@mones.org>
270              Colin Leroy              <colin@colino.net>
271              Paul Mangan              <paul@claws-mail.org>
272              Martin Schaaf            <mascha1@users.sf.net>
273
274
275       Previous team members
276              Keith Edmunds
277              Match Grun
278              Melvin Hadasht
279              Oliver Haertel
280              Christoph Hohmann
281              Alfons Hoogervorst
282              Thorsten Maerz
283              Leandro A. F. Pereira
284              Luke Plant
285              Carsten Schurig
286              Sergey Vlasov
287              Hiroyuki Yamamoto
288
289