man(1)                       Profanity XMPP client                      man(1)



NAME
       /account


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


0.13.1                            2023-08-03                            man(1)