Skip to content
Cross-platform C++ XMPP client and server library
C++ Other
  1. C++ 98.1%
  2. Other 1.9%
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc Implement XEP-0334: Message Processing Hints Sep 8, 2019
examples Modernize codebase using clang-tidy Sep 8, 2019
src Modernize codebase using clang-tidy Sep 8, 2019
AUTHORS Add myself to AUTHORS file Sep 4, 2017 Implement XEP-0334: Message Processing Hints Sep 8, 2019
LICENSE.LGPL Fix for Oct 26, 2009 Install pkgconfig file Sep 4, 2017

Build Status Code Coverage

About QXmpp

QXmpp is a cross-platform C++ XMPP client and server library. It is written in C++ and uses Qt framework.

QXmpp strives to be as easy to use as possible, the underlying TCP socket, the core XMPP RFCs (RFC3920 and RFC3921) and XMPP extensions have been nicely encapsulated into classes. QXmpp comes with full API documentation, automatic tests and many examples.

QXmpp uses Qt extensively, and as such users need to a have working knowledge of C++ and Qt basics (Signals and Slots and Qt data types).

Qt is the only third party library which is required to build QXmpp, but libraries such as speex and theora enable additional features.

QXmpp is released under the terms of the GNU Lesser General Public License, version 2.1 or later.

Building QXmpp

QXmpp requires Qt 5.0 or higher with SSL enabled. It uses CMake as build system.

Build from command line:

mkdir build
cd build
cmake ..
cmake --build .

You can pass the following arguments to CMake:

BUILD_SHARED                  to build with shared type library, otherwise static (default: true)
BUILD_DOCUMENTATION           to build the documentation (default: false)
BUILD_EXAMPLES                to build the examples (default: true)
BUILD_TESTS                   to build the unit tests (default: true)
WITH_OPUS                     to enable opus audio codec (default: false)
WITH_SPEEX                    to enable speex audio codec (default: false)
WITH_THEORA                   to enable theora video codec (default: false)
WITH_VPX                      to enable vpx video codec (default: false)

Installing QXmpp

After building QXmpp, you can install the Headers, Libraries and Documentation using the following command:

Install from command line:

cmake --build . --target install


Look at the example directory for various examples. Here is a description of a few.

  • example_0_connected This example just connects to the xmpp server and start receiving presences (updates) from the server. After running this example, you can see this user online, if it's added in your roster (friends list).

  • example_1_echoClient This is a very simple bot which echoes the message sent to it. Run this example, send it a message from a friend of this bot and you will receive the message back. This example shows how to receive and send messages.


You can find the API documentation for the latest QXmpp version here:

Supported Platforms

It should work on all the platforms supported by Qt. For a complete list of platforms support by Qt, see:

How to report a bug

If you think you have found a bug in QXmpp, we would like to hear about it so that we can fix it. Before reporting a bug, please check if the issue is already know at:

Discussion Group

Join QXmpp Discussion Group for queries, discussions and updates.!forum/qxmpp

You can’t perform that action at this time.