Skip to main content

A console XMPP client

Project description



Forge Page:

Poezio is a console Jabber/XMPP client. Its goal is to use anonymous connections to simply let the user join MultiUserChats. This way, the user doesn’t have to create a Jabber account, exactly like people are using IRC. Poezio’s commands are designed to be (if possible) like commonly used IRC clients (weechat, irssi, etc).

Since version 0.7, poezio can handle real Jabber accounts along with roster and one-to-one conversations, making it a full-featured console Jabber client, but still MultiUserChats-centered. In the future, poezio should implement at a 100% level all XEP related to MUCs, especially XEP 0045.


You need python 3.5 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.

Additionally, you’ll need sphinx to build the documentation pages. To read the documentation without these dependancies just read the rst files in the doc/source/ directory or the generated documentation on the website.

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

You can then launch poezio with

$ ./

you can now simply launch poezio

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:

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).



Jabber ChatRoom:

Report a bug:


Poezio is Free Software. (learn more:

Poezio is released under the zlib License. Please read the COPYING file for details.

The artwork logo was made by Gaëtan Ribémont and released under the Creative Commons BY license (


If you want to contribute, you will be welcome on to announce your ideas, what you are going to do, or to seek help if you have trouble understanding some of the code.

The preferred way to submit changes is through a merge request on gitlab, at, but we also accept contributions on github, or with a simple “please fetch my code on my personal git repository hosted somewhere”


  • People:
    • Todd Eisenberger - Plugin system and OTR support
    • Jérôme Parment (Manfraid) - Code, testing
    • Akim Sadaoui - Code
    • Florian Duraffourg - Code
    • Frédéric Meynadier - Code
    • Georg Lukas - Code
    • Johannes Krude - Code
    • Łabędź - Code
    • Lasse Aagren - Code
    • Lancelot SIX - Code
    • Luke Marlin - Code
    • Maxime Buquet - Code
    • Nicolas Braud-Santoni - Code
    • Perdu - Code
    • Eijebong - Code
    • Gaëtan Ribémont - Logo design
    • Ovart - Testing
    • Koshie - Donation
    • Gapan - Makefile
    • FlashCode (weechat dev) - Useful advices on how to use ncurses efficiently
    • And all the people using and testing poezio, and especially the ones present on the jabber chatroom doing bug reports and/or feature requests.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for poezio, version 0.13.1
Filename, size File type Python version Upload date Hashes
Filename, size poezio-0.13.1.tar.gz (632.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page