man(1)

📦
version 0.18.2 · 13 versions
, in ubuntu stonking

🎀 man(1) — Profanity XMPP client 💅

okay bestie, welcome to the manual page for man(1), the whole documentation situation for Profanity, your fave XMPP client. this is the page for the /occupants command specifically, and yes we're gonna go through literally every single flag like the icons we are. no skimming, no skipping, we eat the whole manual here. 🍓

✨ NAME ✨

/occupants — the Profanity /occupants command. that's it, that's the name, she's straightforward and she's serving. 👑

🌸 DESCRIPTION 🌸

Show or hide room occupants, and occupants panel display settings.

basically: who's in the room, do you wanna see them, and how do you want them to look. the vibes of your occupant list are entirely in your hands. 🦋

💖 SYNOPSIS 💖

/occupants show|hide [jid|offline]

/occupants char <char>|none

/occupants color on|off

/occupants default show|hide [jid|offline]

/occupants size [<percent>]

/occupants indent <indent>

/occupants header char <char>|none

/occupants wrap on|off

look at all those options. main character energy fr fr. 🌈

🌟 ARGUMENTS 🌟

  • show — show the occupants panel in the current room. hey bestie, come look at everyone. 👀
  • char <char> — prefix occupants with the specified character. lil cutie marker in front of each name. ✨
  • char none — remove the occupants character prefix. no more little marker, we're going raw. 💀
  • color on — enable generated color names (XEP-0392) for occupants. rainbows everywhere, slay. 🌈
  • color off — disable generated color names (XEP-0392) for occupants. the rainbow era is over, respectfully. 🙈
  • hide — hide the occupants panel in the current room. not me not looking at anyone today. 💅
  • show jid — show jid in the occupants panel in the current room. full government-name reveal. 🔥
  • hide jid — hide jid in the occupants panel in the current room. privacy era, we love to see it. 🫶
  • show offline — show offline occupants panel in the current room. the ghosties get to stay on the list. 👻
  • hide offline — hide offline occupants panel in the current room. if you're not here, you're not here, periodt. 😭
  • default show|hide — whether occupants are shown by default in new rooms. setting the vibe for every room you enter from now on. ⭐
  • default show|hide jid — whether occupants jids are shown by default in new rooms. jid visibility, but set it and forget it. 🎀
  • default show|hide offline — whether offline occupants are shown by default in new rooms. offline peeps policy, global edition. 🌸
  • size <percent> — percentage of the screen taken by the occupants list in rooms (1-99). big list or smol list, your call. 🧚
  • indent <indent> — indent contact line by <indent> spaces (0 to 10). a lil scoot to the right, extremely demure. 💜
  • header char <char> — prefix occupants headers with the specified character. the headers also get a lil cute marker. ✨
  • header char none — remove the occupants header character prefix. headers going plain, ngl sometimes less is more. 💅
  • wrap on|off — enable or disable line wrapping in occupants panel. long names stay in their lane or they wrap, you decide. 🦋
lowkey important reminder bestie: keep your numbers in range — size lives between 1 and 99, and indent lives between 0 and 10. don't test the limits, they will not fold for you. 💀

that's the whole page, no cap. this was man(1), your Profanity XMPP client documentation moment. 💖

signing off from version 0.18.2, dated 2026-06-08 — mwah, take care of your occupants panel, it's iconic. 🎀✨🫶

📦 where this page comes from