man(1)

📦
version 0.18.2 · 11 versions
, in ubuntu stonking

💖 man(1) — the Profanity XMPP client 💖

okay bestie, listen up, because this one is literally the manual page for man itself but for the Profanity XMPP client's /vcard situation. No cap, it's giving "I want to know everything about everybody's contact card and also aggressively curate my own". Let's go 🦋

🌸 NAME 🌸

/vcard — the Profanity /vcard command. That's it, that's the name, periodt.

✨ DESCRIPTION ✨

So here's the vibe: /vcard is your one-stop shop for vCards. You can read your vCard, read some other user's vCard, pull down a user's avatar via their vCard, or straight up modify your own vCard like the main character you are. 💅

And if you give it no arguments at all? It just shows you your own vCard in a new window — or, if you already have a vCard window chillin' open, it pops it up in that one instead. Cozy. 🫶

🎀 SYNOPSIS 🎀

Every single one of these, exactly as written, no edits, iykyk:

/vcard get [<nick|contact>]
/vcard photo open <nick|contact> [<index>]
/vcard photo save <nick|contact> [output <filepath>] [index <index>]
/vcard set fullname <fullname>
/vcard set name family <family>
/vcard set name given <given>
/vcard set name middle <middle>
/vcard set name prefix <prefix>
/vcard set name suffix <suffix>
/vcard set <index> [<value>]
/vcard set <index> pobox <value>
/vcard set <index> extaddr <value>
/vcard set <index> street <value>
/vcard set <index> locality <value>
/vcard set <index> region <value>
/vcard set <index> pocode <value>
/vcard set <index> country <value>
/vcard set <index> type domestic|international
/vcard set <index> home on|off
/vcard set <index> work on|off
/vcard set <index> voice on|off
/vcard set <index> fax on|off
/vcard set <index> pager on|off
/vcard set <index> msg on|off
/vcard set <index> cell on|off
/vcard set <index> video on|off
/vcard set <index> bbs on|off
/vcard set <index> modem on|off
/vcard set <index> isdn on|off
/vcard set <index> pcs on|off
/vcard set <index> preferred on|off
/vcard set <index> parcel on|off
/vcard set <index> postal on|off
/vcard set <index> internet on|off
/vcard set <index> x400 on|off
/vcard add nickname <nickname>
/vcard add birthday <date>
/vcard add address
/vcard add tel <number>
/vcard add email <userid>
/vcard add jid <jid>
/vcard add title <title>
/vcard add role <role>
/vcard add note <note>
/vcard add url <url>
/vcard remove <index>
/vcard refresh
/vcard save

👑 ARGUMENTS 👑

🔍 Getting & looking

  • get [<nick|contact>] — Grabs your vCard. But if you hand it a nickname or contact? Then it goes and gets their vCard instead. Sneaky little multitasker. 👀
  • photo open <nick|contact> [<index>] — Downloads somebody's photo from their vCard to a file, and then opens it. If you don't specify an index, it just grabs the first photo — which is usually their avatar. ✨
  • photo save <nick|contact> — Downloads a user's photo from their vCard to a file. No index given? It downloads the first photo, which, again, is usually the avatar. And if output isn't specified, the photo lands in profanity's photos directory. 🌈
  • photo open-self [<index>] — Same energy but it's your photo, from your vCard. Downloads it to a file and opens it. No index? First photo (usually avatar) it is. 💖
  • photo save-self — Downloads a photo from your own vCard to a file. No index specified means it grabs the first photo (usually your avatar). No output specified means it goes to profanity's photos directory. Same arguments as photo open, basically the twin sister. 🫶

💅 Setting your main fields

  • set fullname <fullname> — Sets your vCard's fullname to whatever value you gave it. Main character name. Yes. 🌟
  • set name family <family> — Sets your vCard's family name to the specified value.
  • set name given <given> — Sets your vCard's given name to the specified value.
  • set name middle <middle> — Sets your vCard's middle name to the specified value.
  • set name prefix <prefix> — Sets your vCard's prefix name to the specified value.
  • set name suffix <suffix> — Sets your vCard's suffix name to the specified value.

🛠️ Setting stuff by index

  • set <index> [<value>] — Sets the main field of an element in your vCard to the value you gave it. If you didn't give a value? It opens up an editor so you can modify the field there. Important caveat, bestie: this only works on elements that have exactly one field. Noted. 📝
  • set <index> pobox <value> — Sets the P.O. box in an address element in your vCard to the specified value.
  • set <index> extaddr <value> — Sets the extended address in an address element in your vCard to the specified value.
  • set <index> street <value> — Sets the street in an address element in your vCard to the specified value.
  • set <index> locality <value> — Sets the locality in an address element in your vCard to the specified value.
  • set <index> region <value> — Sets the region in an address element in your vCard to the specified value.
  • set <index> pocode <value> — Sets the P.O. code in an address element in your vCard to the specified value.
  • set <index> type domestic|international — Sets the type in an address element in your vCard to either domestic or international. Pick one, you can't have both. 🙈

🏠 The on/off toggles, part one: address / telephone / e-mail

  • set <index> home on|off — Sets the home option in an element in your vCard. (address, telephone, e-mail only)
  • set <index> work on|off — Sets the work option in an element in your vCard. (address, telephone, e-mail only)
  • set <index> preferred on|off — Sets the preferred option in an element in your vCard. (address, telephone, e-mail only)

📞 The telephone-only toggles

  • set <index> voice on|off — Sets the voice option in a telephone element in your vCard.
  • set <index> fax on|off — Sets the fax option in a telephone element in your vCard.
  • set <index> pager on|off — Sets the pager option in a telephone element in your vCard.
  • set <index> msg on|off — Sets the message option in a telephone element in your vCard.
  • set <index> cell on|off — Sets the cellphone option in a telephone element in your vCard.
  • set <index> video on|off — Sets the video option in a telephone element in your vCard.
  • set <index> bbs on|off — Sets the BBS option in a telephone element in your vCard.
  • set <index> modem on|off — Sets the modem option in a telephone element in your vCard.
  • set <index> isdn on|off — Sets the ISDN option in a telephone element in your vCard.
  • set <index> pcs on|off — Sets the PCS option in a telephone element in your vCard.

📬 Address-only & e-mail-only toggles

  • set <index> parcel on|off — Sets the parcel option in an address element in your vCard.
  • set <index> postal on|off — Sets the postal option in an address element in your vCard.
  • set <index> internet on|off — Sets the internet option in an e-mail address in your vCard.
  • set <index> x400 on|off — Sets the X400 option in an e-mail address in your vCard.

➕ Adding things

  • add nickname <nickname> — Adds a nickname to your vCard.
  • add birthday <date> — Adds a birthday date to your vCard. 🎂
  • add address — Adds an address to your vCard.
  • add tel <number> — Adds a telephone number to your vCard.
  • add email <userid> — Adds an e-mail address to your vCard.
  • add jid <jid> — Adds a Jabber ID to your vCard.
  • add title <title> — Adds a title to your vCard.
  • add role <role> — Adds a role to your vCard.
  • add note <note> — Adds a note to your vCard.
  • add url <url> — Adds a URL to your vCard.

🗑️ Removing & managing

  • remove <index> — Removes an element in your vCard, by index. Bye bestie, you're gone. 💀
  • refresh — Refreshes the local copy of the current account's vCard. And yes, this undoes all your unpublished modifications — so if you weren't done editing, that's on you, it's giving "I pressed Ctrl+Z on my whole life". 😭
  • save — Saves your changes to the server. This is the one that makes it real. 🔥
🌟 bestie reminder: no arguments at all = your vCard shows up in a new window, or in an existing vCard window if you've already got one open. That's the whole first paragraph and it's still true. 🧚

and that's the whole page, we ate and left no crumbs 🍓💜 — this was served to you from Profanity 0.18.2, dated 2026-06-08, and yes, man(1) was the title the whole time. mwah, tune in next time 😘💅

📦 where this page comes from