Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 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

0.13.1				  2023-08-03				man(1)

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+14.3.quarterly>

home | help