man(1)

📦

version 0.18.2 · 13 versions

💖 NAME 💖

/account — the Profanity XMPP client's very own /account command, bestie. It's giving account-management main character energy and we're obsessed. 🎀

(also hi, this is the man(1) page for Profanity, lowercase man, the one and only 💅)

✨ DESCRIPTION ✨

Okay so. This command does creating and managing accounts. That's it, that's the whole vibe. 🦋

And listen — if you call it with no arguments at all? It literally just shows you the info for whichever account you're currently on. No notes, it just does that. Slay.

🌸 SYNOPSIS 🌸

Here's the full roster of ways you can call it, no cap, every single one:

/account

/account list

/account show <account>

/account enable|disable <account>

/account default set <account>

/account default off

/account add <account>

/account remove <account>

/account rename <account> <newaccount>

/account set <account> jid <jid>

/account set <account> server <server>

/account set <account> port <port>

/account set <account> status <presence>

/account set <account> status last

/account set <account> <presence> <priority>

/account set <account> resource <resource>

/account set <account> password <password>

/account set <account> eval_password <command>

/account set <account> muc <service>

/account set <account> nick <nick>

/account set <account> otr <policy>

/account set <account> pgpkeyid <pgpkeyid>

/account set <account> startscript <script>

/account set <account> clientid "<name> <version>"

/account set <account> tls force|allow|trust|direct|disable|legacy

/account set <account> auth default|legacy

/account set <account> theme <theme>

/account set <account> session_alarm <max_sessions>

/account clear <account> password

/account clear <account> eval_password

/account clear <account> server

/account clear <account> port

/account clear <account> otr

/account clear <account> pgpkeyid

/account clear <account> startscript

/account clear <account> clientid

/account clear <account> muc

/account clear <account> resource

/account clear <account> session_alarm

🫶 ARGUMENTS 🫶

All the little building blocks, explained like I'm your group chat. 💜

list — Lists all the accounts. Every single one. Show-off behaviour, honestly.
enable <account> — Turns the account on, and it'll be used for autocompletion. Glow-up unlocked. ✨
show <account> — Shows you the details for the account you specified. Receipts. 🧾
disable <account> — Turns the account off. It's not you, it's just... not active right now. 💀
default set <account> — Sets the default account — the one used when you don't pass any argument to the /connect command. Convenient queen. 👑
default off — Clears the default account setting entirely. Gone, deleted, not me. 🙈
add <account> — Creates a brand new account. New account, new era. 🦋
remove <account> — Removes an account. We don't talk about it. 😭
rename <account> <newaccount> — Renames 'account' to 'newaccount'. Identity crisis but make it intentional.
set <account> jid <jid> — Sets the Jabber ID for the account. If you don't set it, the account name gets used instead. Lazy-girl hack, love that. 💅
set <account> server <server> — The chat server, for when it's different to the domainpart of the JID.
set <account> port <port> — The port used for connecting, if it's not the default (which is 5222, or 5223 for SSL). Numbers, but make them cute. 🔢
set <account> status <presence> — The presence status to use on login.
set <account> status last — Uses your last status from before you logged out, when you log in. Throwback behaviour. ⭐
set <account> <presence> <priority> — Sets the priority to use for the presence you specified. The range is -128..127. Negative priorities are so valid.
set <account> resource <resource> — The resource used for this account. Defaults to 'profanity'. Iconic default, honestly. 🎀
set <account> password <password> — The password for the account. real talk: this is currently stored in plaintext if you set it, so... bestie, be aware. 😬
set <account> eval_password <command> — A shell command that gets evaluated to retrieve the password for the account. You can use it to pull the password from a keyring. Fancy and secure, we stan. 🔐
set <account> muc <service> — The default MUC chat service to use. It defaults to the server's disco info response.
set <account> nick <nick> — The default nickname to use when joining chat rooms. Your name, your brand. 💖
set <account> otr <policy> — Overrides the global OTR policy for this account. Peep /otr for the deets.
set <account> pgpkeyid <pgpkeyid> — Sets the ID of the PGP key for this account. Peep /pgp. 🔑
set <account> startscript <script> — Sets the script to execute after connecting. Automatic, effortless, iconic.
set <account> clientid "<name> <version>" — Sets the XMPP client name for discovery, according to XEP-0092. For the privacy geeks out there. Recommendation is to leave it as is. 🕵️
set <account> tls force — Forces a TLS connection, and fails if one cannot be established. This is the default behaviour, so it's already the moment.
set <account> tls allow — Uses TLS for the connection if it's available. Chill, flexible, no pressure.
set <account> tls trust — Forces a TLS connection and trusts the server's certificate. Trusting, but also... 👀
set <account> tls direct — Uses direct TLS for the connection. That means the TLS handshake starts right after the TCP connection is established. Immediate. No small talk.
set <account> tls disable — Disables TLS for the connection. Just so we're clear, that's the insecure option. 💀
set <account> tls legacy — An alternative keyword for 'direct', which was created back when people still thought 'STARTTLS' was the future. History lesson, served. 📜
set <account> auth default — Uses the default authentication process.
set <account> auth legacy — Allows legacy authentication. Retro, in the risky way. 😭
set <account> theme <theme> — Sets the UI theme for the account. Aesthetic is a lifestyle. 🌈
set <account> session_alarm <max_sessions> — Alarms you about suspicious activity if the session count goes over max_sessions. Protective bestie energy. 🚨
clear <account> server — Removes the server setting for this account.
clear <account> port — Removes the port setting for this account.
clear <account> password — Removes the password setting for this account.
clear <account> eval_password — Removes the eval_password setting for this account.
clear <account> otr — Removes the OTR policy setting for this account.
clear <account> pgpkeyid — Removes the pgpkeyid associated with this account.
clear <account> startscript — Removes the startscript associated with this account.
clear <account> clientid — Resets the client's name to default. Back to factory settings, fresh start. ✨
clear <account> theme — Clears the theme setting for the account, so the global theme gets used instead.
clear <account> resource — Removes the resource setting for this account.
clear <account> muc — Removes the default MUC service setting.
clear <account> session_alarm — Disables the session alarm. Sweet silence. 🤫

🦋 EXAMPLES 🦋

Actual real-life usage, copy-paste-able, chef's kiss:

/account add me

/account set me jid ulfhednar@valhalla.edda

/account set me server talk.chat.com

/account set me port 5111

/account set me muc chatservice.mycompany.com

/account set me nick dennis

/account set me status dnd

/account set me dnd -1

/account set me clientid "Profanity 0.42 (Dev)"

/account set me eval_password "pass

/account rename me chattyme

/account clear me pgpkeyid

okay that's literally the whole page bestie, you ate that 💅✨

this was all from Profanity XMPP client version 0.18.2, dated 2026-06-08, and it lives under man(1) — go forth and manage those accounts, periodt 🎀💖🦋

📦 where this page comes from

ubuntu stonking: profanity 0.18.2-1 · GPL-3.0-or-later WITH OpenSSL exception
ubuntu stonking: profanity-light 0.18.2-1 · GPL-3.0-or-later WITH OpenSSL exception
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on 2026-11-03: a language model's rewrite of the original, under its terms