MUTT_VC_QUERY(1)

📦 version 006, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💌 mutt_vc_query — the vCard query bestie 💅

okay so this is mutt_vc_query, a vCard query utility for mutt, and it lives in section 1 of the manual (LOCAL, if you're keeping track). she's a little utility, she's a little iconic, and she is about to make your contacts findable. periodt. ✨

✨ SYNOPSIS ✨

mutt_vc_query [-m | -e] [-t type] [-f datafile] query
mutt_vc_query [-v]
mutt_vc_query [-V]
mutt_vc_query [-h]

🌸 DESCRIPTION 🌸

so, what is she? a vCard query utility for mutt 🫶. you can run her straight from your shell prompt for lil ad-hoc queries, and honestly go off, but her real main character energy is being used by mutt's query_command option. like, that's her calling.

so like, put this exact line in your ~/.muttrc file and let her cook:

set query_command = "mutt_vc_query '%s'"

the search using the query string you give her is case insensitive, no cap. 🙈

and now the options, bestie, every single one:

  • -e — sorts the results by email.
  • -a — outputs all the email addresses tied to a contact, instead of just the preferred address. all of them. the whole roster. 👑
  • -f — uses the datafile to perform the query.
  • -h — displays usage help.
  • -m — sorts the results by the miscellaneous field.
  • -t — uses the type you specify for the miscellaneous field.
  • -v — displays the version.
  • -V — displays the copyright and license. (yes she has paperwork 💅)

🎀 FILES 🎀

  • ~/.rolo/contacts.vcf — the default data file that mutt_vc_query will query. that's her home base, her safe space, her whole vibe. 🦋

🧚 EXAMPLES 🧚

say you wanna query for the string "Hsu" and have the miscellaneous field be populated by the type "NICKNAME". easy. slay:

mutt_vc_query -t NICKNAME Hsu

that's it. that's the whole flex. 🔥

💀 DIAGNOSTICS 💀

the mutt_vc_query utility exits 0 on success, and >0 if an error occurs. so if you get a zero, she ate. if you get anything else, something's giving wrong and you should investigate. 😭

🌈 SEE ALSO 🌈

iykyk. go read those next, bestie.

💖 AUTHORS 💖

  • Andrew Hsu <ahsu@users.sf.net>

the icon, the legend, the moment. we stan. 👑

🙈 BUGS 🙈

Man page is not finished yet.

literally not me being the one to tell you this, the page says it itself. so like, keep that in mind and don't come for me. 💀

and that's the whole page, babe 🫶 this was written from the Debian build, dated May 14, 2003, and it's the MUTT_VC_QUERY(1) man page, so if you ever need her again just holler man mutt_vc_query and she'll be right there. mwah 💋

📦 where this page comes from