man(1)

✨ NAME ✨

okay so bestie, this is the manual for the /ox command in the Profanity XMPP client β€” like, the /ox command, that's her, that's the whole girl. πŸ’…


🌸 DESCRIPTION 🌸

OpenPGP (OX) commands, babes!! πŸŽ€ This is your whole toolkit for managing keys and doing OpenPGP encryption while you're living your best life in chat sessions. It's giving secure, it's giving private, it's giving main character energy.

So here's the thing you need to know, no cap: your OpenPGP key has to have a user-id with your JID URI in it, formatted exactly like xmpp:local@domain.tld. That's non-negotiable bestie, the key has to know who she is. πŸ’–

Wanna make a key from scratch? You can generate one with:

gpg --quick-gen-key xmpp:local@domain.tld future-default default 3y

And for the very first time you set OX up (like, the whole first-time setup saga), go read man profanity-ox-setup for all the deets. πŸ¦‹


🫢 SYNOPSIS 🫢

/ox keys

/ox contacts

/ox start [<contact>]

/ox end

/ox log on|off|redact

/ox char <char>

/ox announce <file>

/ox discover <jid>

/ox request <jid> <keyid>

πŸ’œ ARGUMENTS πŸ’œ

  • keys β€” lists every key the system knows about. all of them. the whole roster. πŸ‘‘
  • contacts β€” shows you the contacts that have public keys assigned to them.
  • start [<contact>] β€” kicks off a PGP encrypted chat! if you don't name a <contact>, she just uses whoever you're currently talking to. convenient fr fr. ✨
  • end β€” ends the PGP encrypted chat with the recipient you're currently with. bye bestie πŸ’”
  • log on|off β€” turns plaintext logging of PGP encrypted messages on or off.
  • log redact β€” still logs your PGP encrypted messages, but swaps the actual contents out for [redacted]. sneaky but make it classy. πŸ™ˆ
  • char <char> β€” sets the character that gets displayed next to PGP encrypted messages.
  • announce <file> β€” announces a public key by pushing it onto the XMPP Server. πŸ“’
  • discover <jid> β€” discovers the public keys of a jid. the OpenPGP Key IDs get displayed for you.
  • request <jid> <keyid> β€” requests a public key. and hey, go run /ox discover to get the available key IDs first (the original page says "to to" here and honestly? we respect her quirks πŸ’€).

🌈 EXAMPLES 🌈

/ox log off
/ox start odin@valhalla.edda
/ox end
/ox char X

and that's the whole page, bestie!! πŸŽ€ this was Profanity XMPP client manual, man(1), source/version 0.18.2, dated 2026-06-08 β€” slay, iconic, periodt. go forth and encrypt responsibly πŸ’–βœ¨πŸ¦‹πŸ‘‘

πŸ“¦ where this page comes from