NAME¶

Net::Gmail::IMAP::Label - IMAP proxy for Google's Gmail that retrieves message labels

VERSION¶

version 0.008

SYNOPSIS¶

    gmail-imap-label [OPTION]...

DESCRIPTION¶

This module provides a proxy that sits between an IMAP client and Gmail's IMAPS server and adds GMail labels to the X-Label header. This proxy uses the Gmail IMAP extensions <https://developers.google.com/gmail/imap/imap-extensions#access_to_gmail_labels_x-gm-labels>.

To use this proxy, your e-mail client will need to connect to the proxy using the IMAP protocol (without SSL).

EXAMPLES¶

The simplest way of starting is to run the proxy on the default port of 10143:

    gmail-imap-label

An alternative port can be specified using the --port option

    gmail-imap-label --port 993

The proxy has been tested with both mutt (v1.5.21) and offlineimap (v6.3.4). Example configuration files for these are available in the "doc" directory.

With mutt, you may have to clear the header cache every so often so that any updated labels are available inside the UI.

INSTALLATION¶

You can either install the package from CPAN <http://p3rl.org/Net::Gmail::IMAP::Label> or from your package manager.

To install the Debian package <https://packages.debian.org/libnet-gmail-imap-label-perl>, run

    apt-get install libnet-gmail-imap-label-perl

SEE ALSO¶

See gmail-imap-label for a complete listing of options.

BUGS¶

Report bugs and submit patches to the repository on Github <https://github.com/zmughal/gmail-imap-label>.

COPYRIGHT¶

Copyright 2011 Zakariyya Mughal.

This program is free software; you can redistribute it and/or modify it under the terms of either:

• the ISC license, or
• the Artistic License version 2.0.

ACKNOWLEDGMENTS¶

Thanks to Paul DeCarlo <http://pjdecarlo.com/> for pointing out the Gmail IMAP extensions that made this a whole lot easier than what I had originally planned on doing.

AUTHOR¶

Zakariyya Mughal <zmughal@cpan.org>

COPYRIGHT AND LICENSE¶

This software is Copyright (c) 2011 by Zakariyya Mughal <zmughal@cpan.org>.

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)