Home

Sup

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

Installation

See below for platform specific instructions. Or you can refer to the general installation process.

Note that installing sup via both your native package manager and using instructions from this wiki will probably cause problems.

Migration and release specific instructions

• Migration-0.13-to-0.14 (or later)
• Using Sup with other clients (when upgrading to 0.15: optional maildir flag/state synchronization)

Platform specific instructions

• Debian / Ubuntu
• Fedora
• Archlinux
• Mac OSX
• FreeBSD
• 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 Maildir before.
• Adding Sources
• Keyboard Reference
• Configuration Options
• Searching your mail
• Secure usage of Sup
• Using Sup with other clients (Maildir flag/state synchronization)

Configuring the way email leaves

• msmtp
• putmail

Configuring the way email is retrieved

• OfflineIMAP
• mbsync/isync

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
• Backing up the index

Troubleshooting and Known Issues

• UTF-8 issues
• CtrlY

Sup development

• Development
• Contributing
• 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
• Why sup ? A philosophical statement by the original creator, William Morgan on why sup was born.