man(1)

NAME
/roster - the Profanity /roster command.

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