goobook(1)

✨ goobook — bestie, your Google contacts are RIGHT THERE 💖

okay so this is goobook(1), it lives in the User Manuals section, and it's basically the little goblin that fetches your Google contacts so you never have to open a browser again. 🦋

---

🌸 SYNOPSIS 🌸

that's it. that's the whole vibe. options, then a command, and you're slaying. 💅

---

🎀 DESCRIPTION 🎀

so, goobook lets you access your Google contacts straight up from the command line. no GUI, no drama, no "please sign in again" jumpscare. ✨

and the best part? it slides into MUAs like mutt like it was always meant to be there. you use it from mutt literally the same way you'd use abook. same energy, same muscle memory, zero learning curve. icon behavior honestly. 👑

---

💅 OPTIONS 💅

• -h, --help — shows the help message and dips. classic. 🫶
• -c FILE, --config FILE — point it at an alternative config file if you're not feeling the default one.
• -v, --verbose — be verbose about what is going on, and it says all of it to stderr. nosy but make it useful. 🙈
• -V, --version — prints the version and exits. short and sweet.
• -d, --debug — dumps debug information to stderr. for when something is giving unwell and you need receipts. 💀

---

🌈 COMMAND 🌈

• authenticate — allows goobook to access your Google contacts using OAuth2. this is the handshake bestie, do it first.
• add [NAME] [EMAIL] [PHONE] — add a brand new Google contact. and here's the delicious part: if NAME and EMAIL aren't specified, it reads an email address from stdin and adds the From: address to your Google contacts. not it being smart?? 🔥
• config-template — displays a config template that can be written to ~/.config/goobookrc. free template, no cap.
• dump_contacts — dumps all your contacts to XML, straight to stdout.
• dump_groups — dumps your contact groups to XML, also to stdout.
• dquery QUERY_STRING — searches contacts for QUERY_STRING and gives you nice vcard-like output. and listen — QUERY_STRING is a Python flavoured regexp where all ' ' is replaced with .*. yes really. the spacebar is a wildcard, iykyk. ✨
• query [-s|--simple] QUERY_STRING — searches contacts for QUERY_STRING with mutt-compatible plain text output. the --simple output format was requested for use with notmuchmail. same lore as above: QUERY_STRING is a Python flavoured regexp where all ' ' is replaced with .*. go off, regex queen. 🧚
• reload — reload contacts from Google and update the cache. the lil refresh moment your soul needed. 🌸

---

🍓 CONFIGURATION 🍓

for most users, honestly? it will be enough to just run this:

and follow the instructions. that's it. that's the whole starter pack. 🎀

and if you want access to more advanced options, you can generate a config file by doing:

an example config can look like this:

[DEFAULT]
cache_expiry_hours: 24

cute, right? 24 hours, just like your attention span for anything that isn't this. ⭐

---

🔥 SEE ALSO 🔥

website: https://pypi.python.org/pypi/goobook/ — go say hi, it's the source of truth. 👑

---

💜 Author 💜

this manual page has been written by Dariusz Dwornikowski and Christer Sjöholm. absolute legends, we thank them for their service. 🫶

---

okay bestie, that's the whole page — this manual was part of the User Manuals collection, dated 2020-09-02, and yes it still says goobook(1) at the bottom like the icon it is. now go query some contacts and live your main character life. 💖✨