= PGPirate

Yarrr, a mouseHole 2.0 app that hijacks gmail basic HTML mode and
verifies/decrypts PGP emails for you (He's a friendly pirate). Assumes you have
GnuPg working correctly.

== Quickstart

# Follow the bouncing ball:

    sudo apt-get install libgpgme-ruby1.8
    ln -s /path/to/pgpirate/lib/pgpfilter.rb ~/.mouseHole/pgpfilter.rb
    ln -s /path/to/pgpirate/lib/pgpirate.rb ~/.mouseHole/pgpirate.rb
    ln -s /path/to/pgpirate/lib/pgpirate ~/.mouseHole/pgpirate
    cd /path/to/mouseHole
    patch -p0 < /path/to/pgpirate/mousehole_ugly_patch_r78
     
# Start up mouseHole
# Enter your PGP passphrase at http://localhost:3704/pgpirate/passphrase

== Notes

Very much a work in progress! Planned improvements include

- Generic support for PGP messages in webpages
- One click signing/encrypting of text areas
- Clean up pgpfilter.rb
- Clean up GpgmeHelper

The patch for mouseHole is required since GMail uses really dodgy HTML. Running
it through Hpricot changes the markup too much and pretty much breaks 
everything. Added support for "ugly" rewrites, which can rewrite the document
as a text string. A page is only converted using Hpricot if a non-ugly rewriter
exists for that page.

Eventually, I want to get mouseHole running off a USB flash drive, so I can
use PGP on foreign computers...