Poezio is a console Jabber/XMPP client. The initial goal was to provide a way of connecting easily to XMPP without the need for an account, exactly like IRC clients. Poezio's commands are also designed to be close, if possible, to the ones commonly used in IRC clients (weechat, irssi, etc).

For this reason, the experience is still centered around chatrooms, despite poezio being a full-featured XMPP client for a very long while.



The stable version of poezio is packaged in a number of GNU/Linux (and OpenBSD) distributions.

If it is not packaged in your distribution, you can run the flatpak or use pip to install the package from Pypi.

From git


You need python 3.7 or higher (preferably the latest) and the associated devel package, to build C modules, and the slixmpp python library. You also need aiodns if you want SRV record support.

The easiest way to have up-to-date dependencies and to be able to test this developement version is to use the update.sh script that downloads them, places them in the right directory, and builds the C module.

You can then launch poezio with

$ ./launch.sh

You can edit the configuration file which is located in ~/.config/poezio/poezio.cfg by default, and you will have to copy and edit data/default_config.cfg if you want to edit the config before the first launch. The default config file is fully commented, but you can also read the “Configuration” documentation page which has links between options and longer descriptions.

Please see the online documentation for more information on installing, configuring or using poezio: https://doc.poez.io/

If you still have questions, or if you're lost, don't hesitate to come talk to us directly on our Jabber chat room (see Contact section).

Please DO report any bug you encounter and ask for any feature you want (we may implement it or not, but it’s always better to ask).