Net::G...::Label(3pm)

📦
version 0.008 · 2 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble

💖 Net::Gmail::IMAP::Label — the perl doc, bestie edition 💖

okay so this is Net::G...::Label(3pm), a User Contributed Perl Documentation page, and honestly? it's giving "tiny module, huge personality". sit down, grab a strawberry 🍓, and let's get into it.

✨ NAME ✨

Net::Gmail::IMAP::Label — an IMAP proxy for Google's Gmail that retrieves message labels. that's the whole job. she fetches labels. she does it well. periodt. 💅

🌸 VERSION 🌸

version 0.008 — tiny number, big heart. 🫶

🦋 SYNOPSIS 🦋

gmail-imap-label [OPTION]...

that's it. that's the vibe. run it, feed it options, watch the magic happen. ✨

👑 DESCRIPTION 👑

so here's the tea, bestie: this module gives you a proxy that sits right in between your IMAP client and Gmail's IMAPS server, and its whole main character moment is adding GMail labels to the X-Label header. literally the labels you already have in Gmail, showing up where your mail client can actually see them. iconic behaviour, no cap. 😭💖

how does she pull this off? with the Gmail IMAP extensions, over here:

https://developers.google.com/gmail/imap/imap-extensions#access_to_gmail_labels_x-gm-labels

⚠️ important detail, don't skip it: to use this proxy, your e-mail client will need to connect to the proxy using the IMAP protocol (without SSL). yes, really. no SSL on the proxy side. that's the setup, bestie.

💜 EXAMPLES 💜

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

gmail-imap-label

want a different port? she's flexible, she has options. use the --port option:

gmail-imap-label --port 993

ngl, this proxy has been tested with both mutt (v1.5.21) and offlineimap (v6.3.4). example configuration files for both of those are available in the "doc" directory. 🎀

and a little heads-up for the mutt girlies specifically: with mutt, you may have to clear the header cache every so often so that any updated labels are available inside the UI. yes, it's annoying. no, we don't make the rules. 🙈

🎀 INSTALLATION 🎀

you've got two paths, both slay:

and if you're on Debian, the Debian package lives at https://packages.debian.org/libnet-gmail-imap-label-perl. to install it, run:

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

boom. installed. 💅

🌈 SEE ALSO 🌈

go look at gmail-imap-label for a complete listing of options. she's got the full menu, this page is just the appetiser. ✨

💀 BUGS 💀

found a bug? got a patch? report bugs and submit patches to the repository on Github:

https://github.com/zmughal/gmail-imap-label

she's waiting for your PR, bestie. 🫶

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.

pick your fighter, both are valid. 😌

🧚 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. king behaviour honestly, saved everyone a whole saga. 👑

🌟 AUTHOR 🌟

Zakariyya Mughal <zmughal@cpan.org>

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)

and that's the whole page!! 🎉 this was perl v5.26.1, dated 2018-04-15, and the page title is Net::G...::Label(3pm) — ok bye, go label some emails, you absolute icon 💅✨🦋

📦 where this page comes from