gnome-gmail(1)

📦 version 2.9, in ubuntu jammy

💌 gnome-gmail — the gnome-gmail(1) manual, but make it cute

okay bestie, sit down, hydrate, and let me tell you about gnome-gmail — the little script that makes GMail and your GNOME desktop actually talk to each other. it lives in the User Commands section of your manual, so you already know it's giving real user-facing main character energy. 💅

✨ NAME ✨

gnome-gmail — Integrate GMail into the GNOME desktop 🦋

like. that's it. that's the whole job. GMail + GNOME = besties, no cap.

🌸 SYNOPSIS 🌸

gnome-gmail [-r file|<mailto-URL>] [--send] [-u <user-email>|--user
<user-email>]

literally just copy-paste that shape into your terminal and you're cooking. 👑

💖 DESCRIPTION 💖

so the gnome-gmail script opens a GMail page in your default web browser, and the message it composes follows whatever RFC2368 mailto: URL you handed it. it doesn't guess, it doesn't freestyle — it reads your URL and builds the compose window accordingly. ✨

and why does this exist, you ask? because this script is the whole reason GMail can be your GNOME Preferred Application for email. click a mail link anywhere in your desktop and boom, GMail opens, dressed and ready. it's giving seamless integration, fr fr. 💜

🎀 OPTIONS 🎀

first up, the star of the show — the positional argument (yes, it gets top billing here, no flag needed):

  • a mailto: URL — this is the whole vibe. the fields To, CC, BCC, Subject, and Body are all supported. the Attach keyword is what you use to point at files you want attached to the message. and if the argument you pass is not well formed? the script just shrugs and assumes it's the recipient. 🙈 and if you pass no argument at all? it opens a default GMail page and lets you live your life. 😌

and now the flags, the little levers and buttons:

  • -s, --send — send immediately. no draft-hesitation era, we hit send. 🔥
  • -u, --user — specify the 'from' address, overriding the stored choice. you're the boss of your own identity now. 👑
  • -r file, --rfc file — send the RFC822-formatted file file. give it a file, it sends that file's whole formatted self. 🍓

🌈 FILES 🌈

  • ~/.config/gnome-gmail/gnome-gmail.conf — Configuration file 💾

that's where your settings live, tucked away in your config dir like a little secret stash. 🫶

💀 BUGS 💀

No known bugs.

which is honestly iconic of them. flawless behavior. not a single thing to report. periodt. ✨

👑 AUTHOR 👑

David Steele (dsteele@gmail.com) — the legend behind the script. say thank you. 🫶

ok so quick vibe check for the whole thing: the argument can be a mailto: URL or a plain recipient if it's malformed, -s/--send fires it off instantly, -u/--user overrides your from-address, and -r/--rfc takes an RFC822-formatted file. keep those straight and you're golden. 💖

this page comes to you from the Linux manual set, dated 7 June 2015, and it's filed under gnome-gmail(1) — mwah, go forth and send some emails bestie 💅🎀✨

📦 where this page comes from