1Balsa(1) Gnome Manpage Balsa(1)
2
6 Balsa - the GNOME e-mail client.
7
9 You can use Balsa to fetch, read, write and send e-mails.
10 It supports
12 * local mailboxes in maildir, mbox and/or mh format,
13 * nested mailboxes,
14 * protocols POP3, IMAP and SMTP,
15 * multithreaded mail retrieval,
16 * GnuPG/GPG encryption, LDAP, Kerberos and SSL,
17 * MIME (view images, save parts),
18 * multiple character sets,
19 * vCard, GPE, and other address book formats,
20 * printing and spell-checking.
21 Balsa is an integral part of the GNOME desktop environment, but it can
23 also be used standalone though it may print some error messages then.
24 For help on using Balsa, see the documentation in its help menu using
26 the Yelp Gnome help/documentation browser.
27 This man page tells about the options of the 'balsa' command, which is
29 used to start Balsa.
30 Most of these options let you tell Balsa that when it starts it should
32 immediately open a mailbox, or the composer, and things like that.
33 When you start Balsa from the command line, not only can you use the
35 command line options described below, any error messages are printed to
36 that terminal too (whether you execute that command in the background
37 or not).
38
40 balsa [ -h | --help ]
41 [ -v | --version ]
42 [ -c | --check-mail ]
43 [ -i | --open-inbox ]
44 [( -m | --compose=)email-address ]
45 [( -a | --attach=)filename ]
46 [( -o | --open-mailbox=)mailbox[:mailbox]... ]
47 [ -u | --open-unread-mailbox ]
48 [ -s | --get-stats ]
49
51 -h, --help
52 Displays a message describing command line syntax of Balsa, giv‐
53 ing many more options than are presented in this man page; Balsa
54 exits immediately after that.
55 -v, --version
57 Balsa prints its version and exits.
58 -c, --check-mail
60 Balsa starts and checks for new mail immediately.
61 -i, --open-inbox
63 Balsa starts and opens the Inbox.
64 -m email-address, --compose=email-address
66 When invoked with this option, Balsa will open its email-com‐
67 poser for a new message with the specified address in the To:
68 field.
69 The email-address parameter can be specified as user@host, e.g.
71 balsa-list@gnome.org, or in URL format, e.g. "Balsa List <balsa-
72 list@gnome.org>".
73 Balsa also serves as the mailto protocol handler.
75 -a FILENAME, --attach=FILENAME
77 When invoked with this option, Balsa will open its email-com‐
78 poser for a new message with the specified file already attached
79 to the message.
80 Example : balsa -a ~/balsa-new.1.gz
82 -o MAILBOX, --open-mailbox=MAILBOX...
84 This makes Balsa start and open the specified mailbox. The
85 mailbox should be specified by its full URL.
86 Example : balsa -o imap://user@mail.example.com/INBOX balsa -o
88 file:///var/mail/user
89 -u, --open-unread-mailbox
91 Open all mailboxes that may contain unread messages.
92 -s, --get-stats
94 Balsa prints the numbers of unread and unsent messages and ex‐
95 its.
96
98 Balsa's website is https://pawsa.fedorapeople.org/balsa
99
102 Any bugs found in Balsa can be reported through the Balsa Developer
103 mailing list at balsa-list@gnome.org, or the online bug-tracking system
104 at https://gitlab.gnome.org/GNOME/balsa/issues.
105 See https://pawsa.fedorapeople.org/balsa/bugs.html for more information
107 on reporting Balsa bugs.
108 Before reporting bugs, please check to see if the bug is mentioned in
110 the FAQ's or the mailing list archive
111 https://mail.gnome.org/mailman/listinfo/balsa-list.
112 When reporting Balsa bugs, it is important to include
114 * a reliable way to reproduce the bug,
115 * version number of Balsa (as well as GTK and GNOME),
116 * OS name and version,
117 * any relevant hardware specs.
118 If a bug is causing a crash, it is very useful if a stack trace can be
120 provided.
121 And of course, patches to rectify the bug are even better.
123
125 See the AUTHORS file included with Balsa, probably at
126 /usr/share/doc/balsa-2.6.3/AUTHORS.
127
129 ~/.balsa/config Balsa's preferences file.
130 ~/.balsa/config-private Balsa's POP and IMAP passwords file.
131 /etc/sound/events/balsa.soundlist system-wide configuration file
132
134 Package names given in parenthesis are Debian package names.
135 mailcap [22m(5) - metamail capabilities file (package: mime-support)
137 metamail (1) - infrastructure for mailcap-based multimedia mail
139 (package: metamail)
140 sendmail (8) - a Mail Transfer Agent (package: exim4-daemon-light)
142 yelp [22m(1) - browse Gnome documentation (package: yelp)
144 GNOME [22m(1) - modern desktop environment (package: gnome-bin)
146
148 (c) 1997-2020 Stuart Parmenter and others, see AUTHORS for a list of
149 people.
150 This is free software; see the source for copying conditions. There is
152 NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
153 PURPOSE.
154Version 2.6.3 February 2020 Balsa(1)