---
name: "profanity-roster"
section: "1"
platform: "linux"
package: "profanity"
version: "1:0.19.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/profanity-roster"
---

# profanity-roster(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\|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 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 roster 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