Poezio is a free software console XMPP client https://poez.io
Go to file
mathieui 583600059a [CI] Use the codeberg woodpecker instance 2023-07-06 14:29:49 +02:00
.github Create a pull request template 2019-11-03 16:35:48 +01:00
.woodpecker [CI] Use the codeberg woodpecker instance 2023-07-06 14:29:49 +02:00
data Update all references to use codeberg urls 2023-07-06 14:29:08 +02:00
doc Update all references to use codeberg urls 2023-07-06 14:29:08 +02:00
plugins plugins: Drop OTR support 2023-04-18 20:00:16 +02:00
poezio typing: fix errors found by the newest mypy 2023-04-22 10:13:38 +00:00
scripts fix: poezio_logs script was broken 2021-03-17 18:21:21 +01:00
test tests: fix expected get_by_tabname input type 2021-07-02 21:10:20 +02:00
tools/sticker-picker Update sticker-picker license to GPL 2022-03-31 14:00:55 +02:00
.gitignore Add gitignore 2018-12-16 16:54:55 +00:00
.gitlab-ci.yml ci: allow failure on build-doc 2023-04-22 12:15:35 +02:00
.travis.yml Update Python version minimum requirement to 3.7 2020-05-01 14:53:18 +02:00
CHANGELOG plugins: Drop OTR support 2023-04-18 20:00:16 +02:00
COPYING Change license for (some previous and) future revisions to GPL-3.0-or-later 2022-03-31 14:00:55 +02:00
Dockerfile Update urls to point to lab.louiz.org 2019-02-14 15:19:11 +00:00
MANIFEST.in Add a /sticker plugin 2022-02-10 01:45:37 +01:00
Makefile Refactor logger.py to make it more testable 2017-11-21 22:40:43 +01:00
README.rst Update all references to use codeberg urls 2023-07-06 14:29:08 +02:00
launch.sh launch.sh: don't change current working directory 2022-08-02 21:31:56 +02:00
requirements-plugins.txt plugins: Drop OTR support 2023-04-18 20:00:16 +02:00
requirements.txt Update all references to use codeberg urls 2023-07-06 14:29:08 +02:00
setup.py Update all references to use codeberg urls 2023-07-06 14:29:08 +02:00
update.sh Remove references to master 2020-09-10 10:33:03 +02:00



Poezio logo

python versions license


Homepage: https://poez.io

Forge Page: https://codeberg.org/poezio/poezio

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, as well as build tools (build-essential, pkg-config, etc.), 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 its always better to ask).



Jabber chat room: poezio@muc.poez.io (web chat)

Report a bug: https://codeberg.org/poezio/poezio/issues/new


Poezio is Free Software. (learn more: http://www.gnu.org/philosophy/free-sw.html)

Poezio is released under the GPL-3.0+ 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.

Migration to Rust

We're currently migrating Poezio to Rust. The migration is happening in the roezio branch on the repository. You're welcome to try it out, report bugs, and contribute!

To be able to run it you will need to install setuptools-rust, and of course the Rust compiler suite. Check out rustc or rustup in your distribution package manager.

You should then be able to run python setup.py build_ext --inplace to compile it locally, and launch poezio via ./launch.py.


If you want to contribute, you will be welcome on poezio@muc.poez.io (web chat) 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 codeberg, at https://codeberg.org/poezio/poezio, 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.