Skip to content


profanity is a console based XMPP client written in C using ncurses and libstrophe, inspired by Irssi.


sudo apt-get install profanity



To connect to an XMPP chat service:


You will be prompted by the status bar to enter your password.

Send one to one message

To open a new window and send a message use the /msg command:

/msg Hello there!

Profanity uses the contact's nickname by default, if one exists. For example:

/msg Bob Are you there bob?

Window navigation

To make a window visible in the main window area, use any of the following:

  • Alt-1 to Alt-0
  • F1 to F10
  • Alt-left, Alt-right

The /win command may also be used. Either the window number may be passed, or the window title:

/win 4
/win MyBuddy

To close the current window:


Adding contacts

To add someone to your roster:

/roster add

To subscribe to a contacts presence (to be notified when they are online/offline etc):

/sub request

To approve a contact's request to subscribe to your presence:

/sub allow

Giving contacts a nickname

/roster nick Bobster

Logging out

To quit profanity:


Configure OMEMO

/omemo gen
/carbons on