1man(1) Profanity XMPP client man(1)
2
6 /roster
7
10 Manage your roster, and roster display settings. Passing no arguments
11 lists all contacts in your roster.
12
15 /roster
16 /roster online
19 /roster show [offline|resource|presence|status|empty|priority|con‐
22 tacts|rooms]
23 /roster hide [offline|resource|presence|status|empty|priority|con‐
26 tacts|rooms]
27 /roster by group|presence|none
30 /roster count unread|items|off
33 /roster count zero on|off
36 /roster color on|off
39 /roster order name|presence
42 /roster unread before|after|off
45 /roster room char <char>|none
48 /roster room private char <char>|none
51 /roster room position first|last
54 /roster room by service|none
57 /roster room order name|unread
60 /roster room unread before|after|off
63 /roster room show server
66 /roster room hide server
69 /roster room use name|jid
72 /roster private room|group|off
75 /roster private char <char>|none
78 /roster header char <char>|none
81 /roster presence indent <indent>
84 /roster contact char <char>|none
87 /roster contact indent <indent>
90 /roster resource char <char>|none
93 /roster resource indent <indent>
96 /roster resource join on|off
99 /roster size <percent>
102 /roster wrap on|off
105 /roster add <jid> [<nick>]
108 /roster remove <jid>
111 /roster remove_all contacts
114 /roster nick <jid> <nick>
117 /roster clearnick <jid>
120 /roster group
123 /roster group show <group>
126 /roster group add <group> <contat>
129 /roster group remove <group> <contact>
132
135 online
136 Show all online contacts in console.
137 show
139 Show the roster panel.
140 show offline
142 Show offline contacts in roster panel.
143 show resource
145 Show contact's connected resources in roster panel.
146 show presence
148 Show contact's presence in roster panel.
149 show status
151 Show contact's status message in roster panel.
152 show empty
154 Show empty groups in roster panel.
155 show priority
157 Show resource priority in roster panel.
158 show contacts
160 Show contacts in roster panel.
161 show rooms
163 Show chat rooms in roster panel.
164 hide
166 Hide the roster panel.
167 hide offline
169 Hide offline contacts in roster panel.
170 hide resource
172 Hide contact's connected resources in roster panel.
173 hide presence
175 Hide contact's presence in roster panel.
176 hide status
178 Hide contact's status message in roster panel.
179 hide empty
181 Hide empty groups in roster panel.
182 hide priority
184 Hide resource priority in roster panel.
185 hide contacts
187 Hide contacts in roster panel.
188 hide rooms
190 Hide chat rooms in roster panel.
191 by group
193 Group contacts in roster panel by roster group.
194 by presence
196 Group contacts in roster panel by presence.
197 by none
199 No grouping in roster panel.
200 count unread
202 Show unread message count with roster headers.
203 count items
205 Show item count with roster headers.
206 count off
208 Do not show any count with roster headers.
209 count zero on
211 Show roster header count when 0.
212 count zero off
214 Hide roster header count when 0.
215 color on
217 Enable generated color names (XEP-0392)
218 color off
220 Disable generated color names (XEP-0392)
221 order name
223 Order roster contacts by name only.
224 order presence
226 Order roster contacts by presence, and then by name.
227 unread before
229 Show unread message count before contact.
230 unread after
232 Show unread message count after contact.
233 unread off
235 Do not show unread message count for contacts.
236 room char <char>
238 Prefix rooms with specified character.
239 room char none
241 Remove room character prefix.
242 room private char <char>
244 Prefix private room chat with specified character when displayed
245 with room.
246 room private char none
248 Remove private room chat character prefix when displayed with room.
249 room position first
251 Show rooms first in roster.
252 room position last
254 Show rooms last in roster.
255 room by service
257 Group rooms by chat service.
258 room by none
260 Do not group rooms.
261 room order name
263 Order rooms by name.
264 room order unread
266 Order rooms by unread messages, and then by name.
267 room unread before
269 Show unread message count before room.
270 room unread after
272 Show unread message count after room.
273 room unread off
275 Do not show unread message count for rooms.
276 room show server
278 Show the conference server with room JIDs.
279 room hide server
281 Do not show the conference server with room JIDs.
282 room use name
284 Use the MUC name as room name.
285 room use jid
287 Use the JID as room name.
288 private room
290 Show room private chats with the room.
291 private group
293 Show room private chats as a separate roster group.
294 private off
296 Do not show room private chats.
297 private char <char>
299 Prefix private room chats with specified character when displayed
300 in separate group.
301 private char none
303 Remove private room chat character prefix.
304 header char <char>
306 Prefix roster headers with specified character.
307 header char none
309 Remove roster header character prefix.
310 contact char <char>
312 Prefix roster contacts with specified character.
313 contact char none
315 Remove roster contact character prefix.
316 contact indent <indent>
318 Indent contact line by <indent> spaces (0 to 10).
319 resource char <char>
321 Prefix roster resources with specified character.
322 resource char none
324 Remove roster resource character prefix.
325 resource indent <indent>
327 Indent resource line by <indent> spaces (0 to 10).
328 resource join on|off
330 Join resource with previous line when only one available resource.
331 presence indent <indent>
333 Indent presence line by <indent> spaces (-1 to 10), a value of -1
334 will show presence on the previous line.
335 size <percent>
337 Percentage of the screen taken up by the roster (1-99).
338 wrap on|off
340 Enable or disable line wrapping in roster panel.
341 add <jid> [<nick>]
343 Add a new item to the roster.
344 remove <jid>
346 Removes an item from the roster.
347 remove_all contacts
349 Remove all items from roster.
350 nick <jid> <nick>
352 Change a contacts nickname.
353 clearnick <jid>
355 Removes the current nickname.
356 group show <group>
358 List all roster items in a group.
359 group add <group> <contact>
361 Add a contact to a group.
362 group remove <group> <contact>
364 Remove a contact from a group.
365
368 /roster
369 /roster add odin@valhalla.edda
372 /roster add odin@valhalla.edda Allfather
375 /roster remove loki@ownserver.org
378 /roster nick odin@valhalla.edda "All Father"
381 /roster clearnick thor@valhalla.edda
384 /roster size 15
387 /roster group
390 /roster group show friends
393 /roster group add friends fenris@ownserver.org
396 /roster group add family Brother
399 /roster group remove colleagues boss@work.com
4020.11.0 2021-09-28 man(1)