FreeBSD Manual Pages
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|con- tacts|rooms] /roster hide [offline|resource|presence|status|empty|priority|con- tacts|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 title bookmark|jid|localpart|name /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 title bookmark|jid|localpart|name Display the bookmark name, JID, JID localpart, or room name as the ros- ter title for MUCs. 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 0.18.1 2026-05-15 man(1)
NAME | DESCRIPTION | SYNOPSIS | ARGUMENTS | EXAMPLES
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=profanity-roster&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>