---
name: "Net::Gmail::IMAP::Label"
section: "3pm"
platform: "linux"
package: "libnet-gmail-imap-label-perl"
version: "0.008-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Net::Gmail::IMAP::Label"
---

# Net::Gmail::IMAP::Label(3pm)

IMAP proxy for Google's Gmail that retrieves message labels

## 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)
```