VMAIL - a vim interface for gmail

Vmail is a Vim interface to Gmail.

Installation

gem install vmail
Test your installation by typing vmail -h. You should see Vmail's help.

On some systems you may run into a PATH issue, where the system can't find the vmail command after installation. Please report this if you encounter this problem, and mention what system you're using. You might want to try

sudo gem install vmail
to see if that puts vmail on your PATH. (If you're using rbenv, running rbenv rehash should do the trick.)

Vmail is evolving rapidly. To update to the latest version, simply run the installation command again.

gem install vmail
If you ever want to uninstall Vmail from your system, just execute this command:

gem uninstall vmail
... and all traces of Vmail will removed, except the few files it creates during execution

Configuration file

To run Vmail, create a yaml file called .vmailrc and save it either in ~/.vmail/default/ or in your home directory. If you do the latter, Vmail will move the file to ~/.vmail/default/ when it starts up.

The .vmailrc file should look something like this. Substitute your own values.

username: dhchoi@gmail.com
password: password
name: Daniel Choi
signature: |
  --
  Sent from Vmail. http://danielchoi.com/software/vmail.html
This file should be formatted in YAML syntax. If you have any unsual characters in a string value, try putting quotes around that value.

You can omit the password key-value pair if you'd rather not have the password saved in the file. In that case, you'll prompted for the password each time you start Vmail.