Scroll to navigation

SUP(1) SUP(1)


sup - a curses-based email client


sup [options]


Sup is a console-based email client for people with a lot of email.

It presents an interface of a list of threads, which are each hierarchical collections email messages. Threads can have multiple tags applied to them. It supports a very fast full-text search, automatic contact-list management, custom code insertion via a Ruby hook system, and more. If you're the type of person who treats email as an extension of your long-term memory, Sup is for you.


List all hooks and descriptions, and quit. Use --hooks-matching to filter

-m, --hooks-matching=<s> : If given, list all hooks and descriptions matching the given pattern. Needs the --list-hooks option (default: )

Turn off threading. Helps with debugging. (Necessarily disables background polling for new messages.)
Don't poll for new messages when starting.
Search for this query upon startup
Compose message to this recipient upon startup
When composing, use this subject
Print version and exit
Show brief help message


Set log level verbosity. Valid values ordered by decresing verbosity: debug info warn error. Default log level is info.
Specify home directory for configuration files and xapian index, defaults to: $HOME/.sup.


Configuration file for Sup
Configuration file for Sup mail sources
Color theme for Sup


mail(1), sup-add(1), sup-config(1), sup-dump(1), sup-import-dump(1), sup-recover-sources(1), sup-sync(1), sup-sync-back-maildir(1), sup-tweak-labels(1)


You are welcome to submit bug reports to the Sup issue tracker, located at



#sup @

Archives: <>


Copyright © 2006-2009 William Morgan <>

Copyright @ 2013-2014 Sup developers

Permission is granted to copy and distribute this manual under the terms of the GNU General Public License; either version 2 or (at your option) any later version.


Sup was originally written by William Morgan <> and is now developed and maintained by the Sup developers.

April 8, 2014 Sup User Manual