logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

/roster - the Profanity /roster command.

Arguments

online
           Show all online contacts in console.

       show
           Show the roster panel.

       showoffline
           Show offline contacts in roster panel.

       showresource
           Show contact's connected resources in roster panel.

       showpresence
           Show contact's presence in roster panel.

       showstatus
           Show contact's status message in roster panel.

       showempty
           Show empty groups in roster panel.

       showpriority
           Show resource priority in roster panel.

       showcontacts
           Show contacts in roster panel.

       showrooms
           Show chat rooms in roster panel.

       hide
           Hide the roster panel.

       hideoffline
           Hide offline contacts in roster panel.

       hideresource
           Hide contact's connected resources in roster panel.

       hidepresence
           Hide contact's presence in roster panel.

       hidestatus
           Hide contact's status message in roster panel.

       hideempty
           Hide empty groups in roster panel.

       hidepriority
           Hide resource priority in roster panel.

       hidecontacts
           Hide contacts in roster panel.

       hiderooms
           Hide chat rooms in roster panel.

       bygroup
           Group contacts in roster panel by roster group.

       bypresence
           Group contacts in roster panel by presence.

       bynone
           No grouping in roster panel.

       countunread
           Show unread message count with roster headers.

       countitems
           Show item count with roster headers.

       countoff
           Do not show any count with roster headers.

       countzeroon
           Show roster header count when 0.

       countzerooff
           Hide roster header count when 0.

       coloron
           Enable generated color names (XEP-0392)

       coloroff
           Disable generated color names (XEP-0392)

       ordername
           Order roster contacts by name only.

       orderpresence
           Order roster contacts by presence, and then by name.

       unreadbefore
           Show unread message count before contact.

       unreadafter
           Show unread message count after contact.

       unreadoff
           Do not show unread message count for contacts.

       roomchar<char>
           Prefix rooms with specified character.

       roomcharnone
           Remove room character prefix.

       roomprivatechar<char>
           Prefix private room chat with specified character when displayed with room.

       roomprivatecharnone
           Remove private room chat character prefix when displayed with room.

       roompositionfirst
           Show rooms first in roster.

       roompositionlast
           Show rooms last in roster.

       roombyservice
           Group rooms by chat service.

       roombynone
           Do not group rooms.

       roomordername
           Order rooms by name.

       roomorderunread
           Order rooms by unread messages, and then by name.

       roomunreadbefore
           Show unread message count before room.

       roomunreadafter
           Show unread message count after room.

       roomunreadoff
           Do not show unread message count for rooms.

       roomshowserver
           Show the conference server with room JIDs.

       roomhideserver
           Do not show the conference server with room JIDs.

       roomusename
           Use the MUC name as room name.

       roomusejid
           Use the JID as room name.

       privateroom
           Show room private chats with the room.

       privategroup
           Show room private chats as a separate roster group.

       privateoff
           Do not show room private chats.

       privatechar<char>
           Prefix private room chats with specified character when displayed in separate group.

       privatecharnone
           Remove private room chat character prefix.

       headerchar<char>
           Prefix roster headers with specified character.

       headercharnone
           Remove roster header character prefix.

       contactchar<char>
           Prefix roster contacts with specified character.

       contactcharnone
           Remove roster contact character prefix.

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

       resourcechar<char>
           Prefix roster resources with specified character.

       resourcecharnone
           Remove roster resource character prefix.

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

       resourcejoinon|off
           Join resource with previous line when only one available resource.

       presenceindent<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).

       wrapon|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_allcontacts
           Remove all items from roster.

       nick<jid><nick>
           Change a contacts nickname.

       clearnick<jid>
           Removes the current nickname.

       groupshow<group>
           List all roster items in a group.

       groupadd<group><contact>
           Add a contact to a group.

       groupremove<group><contact>
           Remove a contact from a group.

Description

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

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.13.1                                             2023-08-03                                             man(1)

Name

       /roster - the Profanity /roster command.

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>

See Also