SPRUCE(1) SPRUCE(1)
NAME
spruce - a GTK+ Internet mail client for X11.
SYNOPSIS
spruce [ options ... ]
DESCRIPTION
Spruce is an X11 mail user agent (commonly known as an email client)
written with the Gtk+ widget set. It is geared towards being extremely
small and fast, supporting all the common features that users want or
need without sacrificing usability or functionality. Spruce's basic
feature set includes:
View, Save, Delete, Expunge, Print, Copy/Move between mailboxes,
Reply and Forward messages.
Compose messages in a simple editor with word-wrap. Allows
inserting text files into the editor to save composition time
through a menu option. Supports adding file attachments via
toolbar button.
Easy manipulation of mailboxes and messages using both menus and
drag-and-drop technology.
Address book to keep a list of long or frequently used addresses.
New mail checking at the press of a button or on a set timer.
Spruce supports MIME (Multipurpose Internet Mail Extensions), an
Internet Standard for representing multipart and multimedia data in
email. Spruce allows you to save MIME objects to files. Spruce's
message composer does not currently have integral multimedia
capability, but any type of data file (including multimedia) can be
attached to a text message and sent using MIME's encoding rules. This
allows any group of individuals with MIME-capable mail software (e.g.
Spruce, CSCMail, Mutt, Pine, or many other programs) to exchange
formatted documents, spreadsheets, image files, etc, via Internet
email.
At the present time, spruce uses it's own SMTP interface to send mail.
Future versions may support the ability to have an external program
like Sendmail send messages as an alternative.
Spruce currently supports several different methods of mail retrieval.
Currently supported are: POP (POP3, APOP, and POP with CRAM-MD5
Authentication), IMAP (also supports CRAM-MD5 Authentication) and mbox
(mbox is the standard UNIX mail format. These mailboxes are commonly
found in /var/spool/mail and/or in the user's home directory: ~/mbox).
- 1 - Formatted: October 24, 2025
SPRUCE(1) SPRUCE(1)
OPTIONS
The command line options/arguments are:
--bindings This will cause spruce to display any and all key
bindings and then exit. Key bindings are
keystrokes that are shrotcuts to common menu
functions.
-h, --help Output spruce's help screen and then exit.
-i, --icons This will cause spruce to use icons in the
toolbars. If used with the next option ( -t , --
text ), spruce will display both text and icons.
-t, --text This will cause spruce to use text in the toolbar
buttons. If combined with the previous option ( -i
, --icons ), both text and icons will be
displayed.
-o, --both This is the equivalent of the previous two
arguments ( --text and --icons ). This is the
default configuration if no other toolbar specific
option(s) are passed.
-v, --version Output spruce's version information and then exit.
SPECIAL OPTIONS
Any combination of these options will cause spruce to automatically
open a new compose window on startup.
--mailto address Specify a mail-to (TO) address
--cc address Specify a carbon-copy (CC) address
--bcc address Specify a blind carbon-copy (BCC) address (not yet
implemented)
--subject subject Specify a subject (must be in quotes if the
subject contains spaces)
- 2 - Formatted: October 24, 2025
SPRUCE(1) SPRUCE(1)
CONFIGURATION
There are several levels of Spruce configuration. Configuration
values at a given level over-ride corresponding values at lower
levels. In order of increasing precedence:
o built-in defaults.
o personal ~/.spruce/spruce.conf file
(may be set via built-in Options dialog.)
o command-line options.
FILES
~/.spruce/spruce.conf configuration file
~/.spruce/addrbook addressbook file
~/.spruce/*.mbx spruce specific mailboxes
~/.spruce/uid.list list of downloaded messages
which prevents spruce from
redownloading the same email
message.
~/.spruce/msgid.list list of read messages
~/.spruce/sprucesig random signature file (takes
precedence over the global
random signature file)
/etc/sprucesig global random signature file
SEE ALSO
http://www.xtorshun.org/spruce/faq.html for frequently asked questions
ACKNOWLEDGMENTS
The Spruce development team includes:
Project Leader: Jeffrey Stedfast
Principal authors: Jeffrey Stedfast, Kristoffer Brnemyr and
Melissa Matthews
Documentation: Jeffrey Stedfast
Web Site: Justin Mecham and Eliot Landrum
Suggestions: Folks from all over!
Copyright (c)1999 by Jeffrey Stedfast
- 3 - Formatted: October 24, 2025
