Scroll to navigation

man(1) Profanity XMPP client man(1)

NAME

/account - the Profanity /account command.

DESCRIPTION

Commands for creating and managing accounts. Calling with no arguments will display information for the current account.

SYNOPSIS

/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|legacy|disable

/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

list

List all accounts.

enable <account>

Enable the account, it will be used for autocompletion.

show <account>

Show details for the specified account.

disable <account>

Disable the account.

default set <account>

Set the default account, used when no argument passed to the /connect command.

default off

Clear the default account setting.

add <account>

Create a new account.

remove <account>

Remove an account.

rename <account> <newaccount>

Rename 'account' to 'newaccount'.

set <account> jid <jid>

Set the Jabber ID for the account, account name will be used if not set.

set <account> server <server>

The chat server, if different to the domainpart of the JID.

set <account> port <port>

The port used for connecting if not the default (5222, or 5223 for SSL).

set <account> status <presence>

The presence status to use on login.

set <account> status last

Use your last status before logging out, when logging in.

set <account> <presence> <priority>

Set the priority (-128..127) to use for the specified presence.

set <account> resource <resource>

The resource to be used for this account, defaults to 'profanity'.

set <account> password <password>

Password for the account, note this is currently stored in plaintext if set.

set <account> eval_password <command>

Shell command evaluated to retrieve password for the account. Can be used to retrieve password from keyring.

set <account> muc <service>

The default MUC chat service to use, defaults to the servers disco info response.

set <account> nick <nick>

The default nickname to use when joining chat rooms.

set <account> otr <policy>

Override global OTR policy for this account, see /otr.

set <account> pgpkeyid <pgpkeyid>

Set the ID of the PGP key for this account, see /pgp.

set <account> startscript <script>

Set the script to execute after connecting.

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

Set XMPP client name for discovery according to XEP-0092. For privacy geeks. Recommendation to leave as is.

set <account> tls force

Force TLS connection, and fail if one cannot be established, this is default behaviour.

set <account> tls allow

Use TLS for the connection if it is available.

set <account> tls trust

Force TLS connection and trust server's certificate.

set <account> tls legacy

Use legacy TLS for the connection. It means server doesn't support STARTTLS and TLS is forced just after TCP connection is established.

set <account> tls disable

Disable TLS for the connection.

set <account> auth default

Use default authentication process.

set <account> auth legacy

Allow legacy authentication.

set <account> theme <theme>

Set the UI theme for the account.

set <account> session_alarm <max_sessions>

Alarm about suspicious activity if sessions count exceeds max_sessions.

clear <account> server

Remove the server setting for this account.

clear <account> port

Remove the port setting for this account.

clear <account> password

Remove the password setting for this account.

clear <account> eval_password

Remove the eval_password setting for this account.

clear <account> otr

Remove the OTR policy setting for this account.

clear <account> pgpkeyid

Remove pgpkeyid associated with this account.

clear <account> startscript

Remove startscript associated with this account.

clear <account> clientid

Reset client's name to default.

clear <account> theme

Clear the theme setting for the account, the global theme will be used.

clear <account> resource

Remove the resource setting for this account.

clear <account> muc

Remove the default MUC service setting.

clear <account> session_alarm

Disable the session alarm.

EXAMPLES

/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 rename me chattyme

/account clear me pgpkeyid

2023-08-03 0.13.1