Home

Sup

Sup is an email client written in Ruby, originally by William Morgan, but now maintained and developed by the Sup community.

Installation

Normally installing sup is as easy as:

gem install sup

If that does not work, please see below for platform specific instructions. Or you can refer to the general installation process.

Platform specific instructions

• Debian / Ubuntu
• Fedora
• Archlinux
• Mac OSX
• Windows: Not supported.

Note: We would like to encourage users of sup to contribute to and edit this wiki. If you discover erroneous information or if you use or configured sup in a way that may be valuable to others, please edit or add the information.

Basic Configuration and Getting Started

• New User Guide
• Complete gmail configuration - recommended if you haven't heard of what Maildir is
• Adding Sources
• Keyboard Reference
• Configuration Options
• Searching your mail

Configuring the way email leaves

• msmtp
• putmail

Configuring the way email is retrieved

• OfflineIMAP

Advanced Usage

• Adding Multiple Sources On The Same Server
• Multiple Accounts And Reply
• Hooks
• Triggering Mail Collection
• Auto Add Labels To New Messages
• Notification Of New Messages
• Composing Hooks
• Viewing Attachments
• Customizing Sup UI
• Customizing Keys
• Vim Integration
• Emacs Integration
• Customizing Colors
• Lbdb Integration
• Printing an email
• Web Browser Integration
• GPG
• File Formats
• Removing A Source
• Thunderbird Import

Experimental Features

• Maildir Syncback

Troubleshooting and Known Issues

• UTF-8 issues
• CtrlY

Sup development

• Development
• Contributing
• Wishlist
• Running from git
• Heliotrope and Turnsole

Elsewhere

• Sup homepage
• sup-talk mailinglist General sup talk [ signup ]
• sup-devel mailinglist Development specific talk
• IRC, #sup @ freenode.net

Meta

• The original Sup wiki was lost, more infomation: OriginalWiki
• Editing This Damn Wiki
• Why sup ? A philosophical statement by the original creator, William Morgan on why sup was born.

Future content

Importing mail from sources

Tutorial for new users how to import mails from their sources (tagging what's outbox and what's inbox and that I already read my 40000 mails) without having to do every single thing (selecting mail, hitting return and x to mark everything as read for instance) by hand would be really, really, really, really awesome.

Address Book / Contact List surfing

(A description of the formats and possible directives of each config file would be super handy)

Internal workings

"I'm nuts/interested and want to know how Sup does its searching/tagging thing"

Spam

Filtering spam