Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
CLAWS MAIL(1)			 User Manuals			 CLAWS MAIL(1)

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

       claws-mail [options]

       Claws  Mail is an email client (and news	reader)	based on GTK+, running
       on the X	Window System, and aiming for:
	      o	Quick response
	      o	Graceful, and sophisticated interface
	      o	Easy configuration, intuitive operation
	      o	Abundant features

       Currently implemented features include:
	      o	POP3 support
	      o	IMAP4rev1 support
	      o	integrated NetNews client
	      o	unlimited multiple account handling
	      o	thread display
	      o	filtering
	      o	MIME (attachments)
	      o	built-in image view
	      o	X-Face and (colour) Face support
	      o	multiple MH folder support
	      o	mbox importing / exporting
	      o	external editor	support
	      o	message	queueing
	      o	automatic mail checking
	      o	draft message function
	      o	template function
	      o	line-wrapping
	      o	clickable URI
	      o	XML-based address book
	      o	LDAP, vCard, and JPilot	support
	      o	newly arrived and unread message management
	      o	Mew/Wanderlust-like key	bind
	      o	printing
	      o	APOP authentication support
	      o	SMTP AUTH support
	      o	SSL support (POP3, SMTP, IMAP4rev1)
	      o	IPv6 support
	      o	drag & drop (partially implemented)
	      o	GnuPG support
	      o	automake + autoconf support
	      o	internationalization of	UI messages by gettext
	      o	support	of many	code sets, including UTF-8 (Unicode) (when us-
	      ing libjconv)
	      o	support	for plugins

       This list is not	complete.

	--compose [address]
	--compose-from-file file
	--subscribe [uri]
	--attach file1 [file2]...
	--status folder[/subfolder]
	--select [#mh/mailbox/]folder[/msg|/msgid]
	--alternate-config-dir [dir]
	--geometry WxH+X+Y

	      Default directory	for mail storage.

	      Global program directory.

	      Manual files in HTML, PDF, PostScript and	plain text format.

	      Global themes directory.

	      Directory	for plugins.

	      Directory	for header files.

	      Default directory	for user's configuration files directory.

	      Addressbook files.

	      Automatic	Faces and X-Faces files	for accounts.

	      SSL certificates received	from mail servers.

	      Tags directory.

	      User-defined templates directory.

	      User's themes directory.

	      Configuration for	account(s).

	      User-defined custom actions.

	      User-defined address book	custom attributes.

	      Claws Mail logfile.

	      Main configuration file.

	      User-specified commands.

	      Configuration for	custom headers for sending mail.

	      Configuration for	custom display of headers in message view.

	      Editable extra headers to	be added to compose window combobox.

	      All folders' attributes.

	      Folder hierarchy listing.

	      Optional GTK+ settings to	be load	on startup.

	      Filtering	and Processing function	configuration.

	      Menu shortcut-key	configuration.

	      User-specified searches in message bodies.

	      User-specified quick-search list.

	      User-specified searches in message bodies.

	      User-specified searches in message list.

	      User saved passwords.

	      User-specified tag list.

	      User-defined custom toolbars.

       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.

	      Claws Mail log file.

       To run this program the standard	way type:


       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: head-
	      ers  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 destina-
	      tion recipient are: subject, from, cc, bcc,  in-reply-to,	 body,
	      insert (insert a file in body part, needs	an absolute path), at-
	      tach (attach a file, needs an absolute  path,  see  also:	 --at-

	      Receive new messages.

	      Receive new messages from	all accounts.

	      Cancel receiving of messages.

	      Cancel sending of	messages.

	      Send all queued messages.

	      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]

	      Show the total number of messages	per folder:
	      [new][unread][unread answers to marked][total]

	      Show session statistics.

	      Reset session statistics.

       --select	[#mh/mailbox/]folder[/msg|/msgid]
	      On startup, jumps	to the specified folder/message.

	      Start  Claws  Mail  in (or switch	to, if already running)	online

	      Start Claws Mail in (or switch to, if already  running)  offline

       --help Display the help message and exit.

       --exit Exit Claws Mail.

	      For  debug  mode (on Windows systems output is written to	a file
	      instead of standard error	output,	see Windows only on FILES sec-

	      Toggle debug mode	of the running Claws Mail instance.

	      Display version number and exit.

	      Display version number and compiled-in features then exit.

	      Display the CONFIG-DIR and exit.

       --alternate-config-dir [dir]
	      Start  Claws Mail	with the configuration stored in the [dir] di-

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

	      If defined disables crash	dialog (only if	Claws  Mail  has  been
	      built with crash dialog feature enabled).

	      Default host and display number to use.

	      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.

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

	      Assumes that filenames are in the	locale encoding	rather than in

       HOME   Full path	of the user's home directory.

	      Locale  to  use for non-windows systems (the first one not empty
	      is used).

	      If defined overrides default J-Pilot charset (CP1252).

	      If defined regular expressions matching follows POSIX standards.

	      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.

	      Use this CA certificates directory instead known system directo-

	      Use  this	CA certificates	file instead of	searching known	system

       USER   Used to initialize default "user_id" preference in newly created

       You  can	 search	 for  existing	bugs and report	new ones on Claws Mail

       1999-2017 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 <><>
       (C) 1999-2003 Michael Natterer <>
       (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 <>
       (C) 1998-2002 Sendmail, Inc.
       (C) 2007-2008 Juha Kautto (juha at
       (C) 1994-2002 World Wide	Web Consortium
       (C) 1999	Graham Davison
       (C) 1999	Eric Busboom
       (C) 2000, Eric Busboom,
       (C) 2002-2007 Randall Hand <>
       (C) 2001	by Werner Koch <>
       (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 <>
       (C) 2004,2005  Nathan J.	Conrad <>
       (C) 2004	Karl Soderstrom	<>
       (C) 2000	Helix Code, Inc. (

       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

       The Claws Mail Team

	   Holger Berndt	    <>
	   Tristan Chabredier	    <>
	   Andrej Kacian	    <>
	   Darko Koruga		    <>
	   Ricardo Mones Lastra	    <>
	   Charles Lehner	    <>
	   Colin Leroy		    <>
	   Paul	Mangan		    <>
	   Salvatore De	Paolis	    <>
	   Pawel Pekala		    <>
	   Michael Rasmussen	    <>

       Previous	team members

	   Hoa Viet 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 Ya-

       Claws Mail Homepage

       Claws Mail frequently asked questions

       Claws Mail online manual

       Claws Mail plugins

       X(7), xwininfo(1).

The Claws Mail team		March 26, 2017			 CLAWS MAIL(1)


Want to link to this manual page? Use this URL:

home | help