profanity-roster - Man Page

/roster

Description

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

Synopsis

/roster

/roster online

/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

Info

2023-08-03 0.13.1 Profanity XMPP client