Scroll to navigation

man(1) Profanity XMPP client man(1)

NAME

/roster

DESCRIPTION

Manage your roster, and roster display settings. Passing no arguments lists all contacts in your roster.

SYNOPSIS

/roster

/roster online

/roster show [offline|resource|presence|status|empty|priority|contacts|rooms]

/roster hide [offline|resource|presence|status|empty|priority|contacts|rooms]

/roster by group|presence|none

/roster count unread|items|off

/roster count zero on|off

/roster color on|off

/roster order name|presence

/roster unread before|after|off

/roster room char <char>|none

/roster room private char <char>|none

/roster room position first|last

/roster room by service|none

/roster room order name|unread

/roster room unread before|after|off

/roster room show server

/roster room hide server

/roster room use name|jid

/roster private room|group|off

/roster private char <char>|none

/roster header char <char>|none

/roster presence indent <indent>

/roster contact char <char>|none

/roster contact indent <indent>

/roster resource char <char>|none

/roster resource indent <indent>

/roster resource join on|off

/roster size <percent>

/roster wrap on|off

/roster add <jid> [<nick>]

/roster remove <contact>

/roster remove_all contacts

/roster nick <jid> <nick>

/roster clearnick <jid>

/roster group

/roster group show <group>

/roster group add <group> <contat>

/roster group remove <group> <contact>

ARGUMENTS

online

Show all online contacts in console.

show

Show the roster panel.

show offline

Show offline contacts in roster panel.

show resource

Show contact's connected resources in roster panel.

show presence

Show contact's presence in roster panel.

show status

Show contact's status message in roster panel.

show empty

Show empty groups in roster panel.

show priority

Show resource priority in roster panel.

show contacts

Show contacts in roster panel.

show rooms

Show chat rooms in roster panel.

hide

Hide the roster panel.

hide offline

Hide offline contacts in roster panel.

hide resource

Hide contact's connected resources in roster panel.

hide presence

Hide contact's presence in roster panel.

hide status

Hide contact's status message in roster panel.

hide empty

Hide empty groups in roster panel.

hide priority

Hide resource priority in roster panel.

hide contacts

Hide contacts in roster panel.

hide rooms

Hide chat rooms in roster panel.

by group

Group contacts in roster panel by roster group.

by presence

Group contacts in roster panel by presence.

by none

No grouping in roster panel.

count unread

Show unread message count with roster headers.

count items

Show item count with roster headers.

count off

Do not show any count with roster headers.

count zero on

Show roster header count when 0.

count zero off

Hide roster header count when 0.

color on

Enable generated color names (XEP-0392)

color off

Disable generated color names (XEP-0392)

order name

Order roster contacts by name only.

order presence

Order roster contacts by presence, and then by name.

unread before

Show unread message count before contact.

unread after

Show unread message count after contact.

unread off

Do not show unread message count for contacts.

room char <char>

Prefix rooms with specified character.

room char none

Remove room character prefix.

room private char <char>

Prefix private room chat with specified character when displayed with room.

room private char none

Remove private room chat character prefix when displayed with room.

room position first

Show rooms first in roster.

room position last

Show rooms last in roster.

room by service

Group rooms by chat service.

room by none

Do not group rooms.

room order name

Order rooms by name.

room order unread

Order rooms by unread messages, and then by name.

room unread before

Show unread message count before room.

room unread after

Show unread message count after room.

room unread off

Do not show unread message count for rooms.

room show server

Show the conference server with room JIDs.

room hide server

Do not show the conference server with room JIDs.

room use name

Use the MUC name as room name.

room use jid

Use the JID as room name.

private room

Show room private chats with the room.

private group

Show room private chats as a separate roster group.

private off

Do not show room private chats.

private char <char>

Prefix private room chats with specified character when displayed in separate group.

private char none

Remove private room chat character prefix.

header char <char>

Prefix roster headers with specified character.

header char none

Remove roster header character prefix.

contact char <char>

Prefix roster contacts with specified character.

contact char none

Remove roster contact character prefix.

contact indent <indent>

Indent contact line by <indent> spaces (0 to 10).

resource char <char>

Prefix roster resources with specified character.

resource char none

Remove roster resource character prefix.

resource indent <indent>

Indent resource line by <indent> spaces (0 to 10).

resource join on|off

Join resource with previous line when only one available resource.

presence indent <indent>

Indent presence line by <indent> spaces (-1 to 10), a value of -1 will show presence on the previous line.

size <percent>

Percentage of the screen taken up by the roster (1-99).

wrap on|off

Enable or disable line wrapping in roster panel.

add <jid> [<nick>]

Add a new item to the roster.

remove <jid>

Removes an item from the roster.

remove_all contacts

Remove all items from roster.

nick <jid> <nick>

Change a contacts nickname.

clearnick <jid>

Removes the current nickname.

group show <group>

List all roster items in a group.

group add <group> <contact>

Add a contact to a group.

group remove <group> <contact>

Remove a contact from a group.

EXAMPLES

/roster

/roster add odin@valhalla.edda

/roster add odin@valhalla.edda Allfather

/roster remove loki@ownserver.org

/roster nick odin@valhalla.edda "All Father"

/roster clearnick thor@valhalla.edda

/roster size 15

/roster group

/roster group show friends

/roster group add friends fenris@ownserver.org

/roster group add family Brother

/roster group remove colleagues boss@work.com

2023-08-03 0.13.1