1man(1)                       Profanity XMPP client                      man(1)
2
3
4

NAME

6       /account
7
8

DESCRIPTION

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

SYNOPSIS

15       /account
16
17
18       /account list
19
20
21       /account show <account>
22
23
24       /account enable|disable <account>
25
26
27       /account default set <account>
28
29
30       /account default off
31
32
33       /account add <account>
34
35
36       /account remove <account>
37
38
39       /account rename <account> <newaccount>
40
41
42       /account set <account> jid <jid>
43
44
45       /account set <account> server <server>
46
47
48       /account set <account> port <port>
49
50
51       /account set <account> status <presence>
52
53
54       /account set <account> status last
55
56
57       /account set <account> <presence> <priority>
58
59
60       /account set <account> resource <resource>
61
62
63       /account set <account> password <password>
64
65
66       /account set <account> eval_password <command>
67
68
69       /account set <account> muc <service>
70
71
72       /account set <account> nick <nick>
73
74
75       /account set <account> otr <policy>
76
77
78       /account set <account> pgpkeyid <pgpkeyid>
79
80
81       /account set <account> startscript <script>
82
83
84       /account set <account> clientid "<name> <version>"
85
86
87       /account set <account> tls force|allow|trust|legacy|disable
88
89
90       /account set <account> auth default|legacy
91
92
93       /account set <account> theme <theme>
94
95
96       /account set <account> session_alarm <max_sessions>
97
98
99       /account clear <account> password
100
101
102       /account clear <account> eval_password
103
104
105       /account clear <account> server
106
107
108       /account clear <account> port
109
110
111       /account clear <account> otr
112
113
114       /account clear <account> pgpkeyid
115
116
117       /account clear <account> startscript
118
119
120       /account clear <account> clientid
121
122
123       /account clear <account> muc
124
125
126       /account clear <account> resource
127
128
129       /account clear <account> session_alarm
130
131

ARGUMENTS

133       list
134           List all accounts.
135
136       enable <account>
137           Enable the account, it will be used for autocompletion.
138
139       show <account>
140           Show details for the specified account.
141
142       disable <account>
143           Disable the account.
144
145       default set <account>
146           Set the default account, used when no argument passed to the  /con‐
147           nect command.
148
149       default off
150           Clear the default account setting.
151
152       add <account>
153           Create a new account.
154
155       remove <account>
156           Remove an account.
157
158       rename <account> <newaccount>
159           Rename 'account' to 'newaccount'.
160
161       set <account> jid <jid>
162           Set the Jabber ID for the account, account name will be used if not
163           set.
164
165       set <account> server <server>
166           The chat server, if different to the domainpart of the JID.
167
168       set <account> port <port>
169           The port used for connecting if not the default (5222, or 5223  for
170           SSL).
171
172       set <account> status <presence>
173           The presence status to use on login.
174
175       set <account> status last
176           Use your last status before logging out, when logging in.
177
178       set <account> <presence> <priority>
179           Set the priority (-128..127) to use for the specified presence.
180
181       set <account> resource <resource>
182           The resource to be used for this account, defaults to 'profanity'.
183
184       set <account> password <password>
185           Password  for  the account, note this is currently stored in plain‐
186           text if set.
187
188       set <account> eval_password <command>
189           Shell command evaluated to retrieve password for the  account.  Can
190           be used to retrieve password from keyring.
191
192       set <account> muc <service>
193           The  default MUC chat service to use, defaults to the servers disco
194           info response.
195
196       set <account> nick <nick>
197           The default nickname to use when joining chat rooms.
198
199       set <account> otr <policy>
200           Override global OTR policy for this account, see /otr.
201
202       set <account> pgpkeyid <pgpkeyid>
203           Set the ID of the PGP key for this account, see /pgp.
204
205       set <account> startscript <script>
206           Set the script to execute after connecting.
207
208       set <account> clientid "<name> <version>"
209           Set XMPP client name for discovery according to XEP-0092. For  pri‐
210           vacy geeks. Recommendation to leave as is.
211
212       set <account> tls force
213           Force  TLS  connection, and fail if one cannot be established, this
214           is default behaviour.
215
216       set <account> tls allow
217           Use TLS for the connection if it is available.
218
219       set <account> tls trust
220           Force TLS connection and trust server's certificate.
221
222       set <account> tls legacy
223           Use legacy TLS for the connection. It means server doesn't  support
224           STARTTLS  and  TLS  is  forced  just after TCP connection is estab‐
225           lished.
226
227       set <account> tls disable
228           Disable TLS for the connection.
229
230       set <account> auth default
231           Use default authentication process.
232
233       set <account> auth legacy
234           Allow legacy authentication.
235
236       set <account> theme <theme>
237           Set the UI theme for the account.
238
239       set <account> session_alarm <max_sessions>
240           Alarm about suspicious activity if sessions count exceeds  max_ses‐
241           sions.
242
243       clear <account> server
244           Remove the server setting for this account.
245
246       clear <account> port
247           Remove the port setting for this account.
248
249       clear <account> password
250           Remove the password setting for this account.
251
252       clear <account> eval_password
253           Remove the eval_password setting for this account.
254
255       clear <account> otr
256           Remove the OTR policy setting for this account.
257
258       clear <account> pgpkeyid
259           Remove pgpkeyid associated with this account.
260
261       clear <account> startscript
262           Remove startscript associated with this account.
263
264       clear <account> clientid
265           Reset client's name to default.
266
267       clear <account> theme
268           Clear  the  theme setting for the account, the global theme will be
269           used.
270
271       clear <account> resource
272           Remove the resource setting for this account.
273
274       clear <account> muc
275           Remove the default MUC service setting.
276
277       clear <account> session_alarm
278           Disable the session alarm.
279
280

EXAMPLES

282       /account add me
283
284
285       /account set me jid ulfhednar@valhalla.edda
286
287
288       /account set me server talk.chat.com
289
290
291       /account set me port 5111
292
293
294       /account set me muc chatservice.mycompany.com
295
296
297       /account set me nick dennis
298
299
300       /account set me status dnd
301
302
303       /account set me dnd -1
304
305
306       /account set me clientid "Profanity 0.42 (Dev)"
307
308
309       /account rename me chattyme
310
311
312       /account clear me pgpkeyid
313
314
3150.13.1                            2023-08-03                            man(1)
Impressum