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)