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)