1SUP(1) SUP(1)
2
3
4
6 sup - a curses-based email client
7
9 sup [options]
10
12 Sup is a console-based email client for people with a lot of email.
13
14 It presents an interface of a list of threads, which are each hierar‐
15 chical collections email messages. Threads can have multiple tags ap‐
16 plied to them. It supports a very fast full-text search, automatic
17 contact-list management, custom code insertion via a Ruby hook system,
18 and more. If you’re the type of person who treats email as an exten‐
19 sion of your long-term memory, Sup is for you.
20
22 -l, --list-hooks
23 List all hooks and descriptions, and quit. Use –hooks-matching
24 to filter
25
26 -m, --hooks-matching=<s>
27 If given, list all hooks and descriptions matching the given
28 pattern. Needs the –list-hooks option (default: )
29
30 -n, --no-threads
31 Turn off threading. Helps with debugging. (Necessarily dis‐
32 ables background polling for new messages.)
33
34 -o, --no-initial-poll
35 Don’t poll for new messages when starting.
36
37 -s QUERY, --search QUERY
38 Search for this query upon startup
39
40 -c STRING, --compose STRING
41 Compose message to this recipient upon startup
42
43 -j STRING, --subject STRING
44 When composing, use this subject
45
46 -v, --version
47 Print version and exit
48
49 -h, --help
50 Show brief help message
51
53 SUP_LOG_LEVEL
54 Set log level verbosity. Valid values ordered by decresing ver‐
55 bosity: debug info warn error. Default log level is info.
56
57 SUP_BASE\
58 Specify home directory for configuration files and xapian index,
59 defaults to: $HOME/.sup.
60
62 $HOME/.sup/config.yaml
63 Configuration file for Sup
64
65 $HOME/.sup/sources.yaml
66 Configuration file for Sup mail sources
67
68 $HOME/.sup/colors.yaml
69 Color theme for Sup
70
72 mail(1), sup-add(1), sup-config(1), sup-dump(1), sup-import-dump(1),
73 sup-recover-sources(1), sup-sync(1), sup-sync-back-maildir(1), sup-
74 tweak-labels(1)
75
77 You are welcome to submit bug reports to the Sup issue tracker, located
78 at
79
80 <https://github.com/sup-heliotrope/sup/issues>
81
83 The Sup web page:
84 <http://supmua.org/>
85
86 Code repository:
87 <https://github.com/sup-heliotrope/sup/>
88
89 Sup Wiki:
90 <https://github.com/sup-heliotrope/sup/wiki/>
91
92 Sup IRC channel:
93 #sup @ freenode.net
94
95 Mailing list:
96 supmua@googlegroups.com
97
98 supmua+subscribe@googlegroups.com
99
100 Archives: <https://groups.google.com/d/forum/supmua/>
101
103 Copyright © 2006-2009 William Morgan <mworgan-sup@masanjin.net>
104
105 Copyright @ 2013-2014 Sup developers
106
107 Permission is granted to copy and distribute this manual under the
108 terms of the GNU General Public License; either version 2 or (at your
109 option) any later version.
110
112 Sup was originally written by William Morgan <wmorgan-sup@masanjin.net>
113 and is now developed and maintained by the Sup developers.
114
115
116
117Sup User Manual April 8, 2014 SUP(1)