Skip to content

Profanity

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

Installation⚑

sudo apt-get install profanity

Usage⚑

Connect⚑

To connect to an XMPP chat service:

/connect user@server.com

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 mycontact@server.com 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 someroom@chatserver.org
/win MyBuddy

To close the current window:

/close

Adding contacts⚑

To add someone to your roster:

/roster add newfriend@server.chat.com

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

/sub request newfriend@server.chat.com

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

/sub allow newfriend@server.chat.com

Giving contacts a nickname⚑

/roster nick bob@company.org Bobster

Logging out⚑

To quit profanity:

/quit

Configure OMEMO⚑

/omemo gen
/carbons on

References⚑