Source

Wiki Pages / Sup

Full commit
[[http://sup.rubyforge.org/|Sup]] is a [[CLI]] email client written in [[Ruby]].

== Setting up Sup with Google Apps

//This was going to be a blog post I never published.//

David Patrick (of the [[http://linuxcaffe.ca/|Linuxcaffe]]) introduced me
to [[http://sup.rubyforge.org/|Sup]] on
[[http://twitter.com/mylesb/status/6131420817|Friday night]]. Sup is a
console based email client written in Ruby. It took me a little while but
I found a way to set it up using a Google Apps account.

Run `sup-config` and start configuring the basics. When It gets to:

	Howdy neighbor! This here's sup-config, ready to help
	you jack in to the next generation of digital cyberspace:
	the text-based email program. Get ready to be the envy of
	everyone in your internets with your amazing keyboarding
	skills! Jump from email to email with nary a click of the
	mouse!
	
	Just answer these simple questions and you'll be on your
	way.
	
	What's your name? (enter for "Myles Braithwaite"): 
	What's your (primary) email address? (enter for "myles@local"):

Obviously you want to enter you name and email address in the above
fields.

	Ok, your from header will look like this:
	  From: Myles Braithwaite <me@mylesbraithwaite.com>
	
	Do you have any alternate email addresses that also receive
	email? If so, enter them now, separated by spaces.
	Alternate email addresses: 

Any email alias you might have.

	What file contains your signature? (enter for "/Users/myles/.signature"): 

Be extremely careful with this option. Horde (a webmail client) save it's
signature in the folder in your home directory called .signature. I
suggest changing the folder to $HOME/.sup/signature.

	What editor would you like to use? (enter for "/usr/bin/vim"): 

I am a vim fan but if you want to you could enter the path to nano.

	Now, we'll tell Sup where to find all your email.
	Current sources:
	  No sources!
	
	1. Add a new source.
	2. Done adding sources!
	Your wish? 1
	Ok, adding a new source.
	1. mbox file
	2. maildir directory
	3. remote mbox file (accessible via ssh)
	4. IMAP server (secure)
	5. IMAP server (unsecure)
	6. Get me out of here!
	What type of mail source is it? 4

You want to use an IMAP server that is secure.

	Ok, now for the details.
	What is the IMAP server (host, or host:port notation)? (enter for "localhost"): imap.gmail.com:993

Google's IMAP server is imap.gmail.com

	What's the folder path? (enter for "INBOX"): %5BGmail%5D/All%20Mail

I use All Mail folder.

	I'm going to add this source: imaps://imap.gmail.com:993/%5BGmail%5D/All%20Mail
	Does that look right? (enter for "y"): y
	Does this source ever receive new messages? (enter for "y"): y
	Should new messages be automatically archived? (I.e. not appear in your inbox,
	though still be accessible via search.) (enter for "n"): n
	Enter any labels to be automatically added to all messages from this source,
	separated by spaces (or 'none'): personal

Because I am adding more than one email I am going to add a label.

	Ok, trying to run "/Users/myles/.gem/ruby/1.8/bin/sup-add --labels=personal imaps://imap.gmail.com:993/%5BGmail%5D/All%20Mail"...
	Username for imap.gmail.com: me@mylesbraithwaite.com
	Password for imap.gmail.com: 
	
	Adding imaps://imap.gmail.com:993/%5BGmail%5D/All%20Mail...
	Great! Added!
	
	Now, we'll tell Sup where to find all your email.
	Current sources:
	* imaps://imap.gmail.com:993/%5BGmail%5D/All%20Mail
	
	1. Add a new source.
	2. Done adding sources!
	Your wish? 2
	
	Sup needs to know where to store your sent messages.
	Only sources capable of storing mail will be listed.
	
	1. Default (an mbox in ~/.sup, aka sup://sent)
	2. imaps://imap.gmail.com:993/%5BGmail%5D/All%20Mail
	Store my sent mail in? 1

Gmail stores send mail a little differently so just use the local mailbox.

	Ok, I've saved you up a nice lil' /Users/myles/.sup/config.yaml.
	
	The final step is to import all your messages into the Sup index.
	Depending on how many messages are in the sources, this could take
	quite a while.
	
	Run sup-sync to import all messages now? (enter for "n"): n
	
	Okee doke, you've got yourself an index of 0 messages. Looks
	like you're ready to jack in to cyberspace there, cowboy.
	
	Just one last command:
	
	  /Users/myles/.gem/ruby/1.8/bin/sup
	
	Have fun!

When all thats done just run `sup-sync` and you done. This command will **download all of your email**.

The next thing you will have to setup is Gmail's SMTP server.