Skip to content
/ qxmpp Public
forked from qxmpp-project/qxmpp

Cross-platform C++ XMPP client and server library

License

Notifications You must be signed in to change notification settings

SkBlaz/qxmpp

This branch is 7 commits ahead of, 1113 commits behind qxmpp-project/qxmpp:master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

cd3f944 · Jun 27, 2021
Apr 17, 2021
Mar 16, 2020
Mar 11, 2021
Feb 26, 2021
Jun 27, 2021
May 21, 2021
Jul 12, 2020
Feb 2, 2020
Mar 31, 2020
Dec 8, 2019
Mar 15, 2021
Mar 17, 2021
Oct 26, 2009
Sep 24, 2018
Mar 17, 2021
May 18, 2020

Repository files navigation

QXmpp XMPP:2021 Client IM Mobile+ Compliance Badge Build Status Code Coverage Latest release Website

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 (RFC6120 and RFC6121) and XMPP extensions have been nicely encapsulated into classes. QXmpp is ready to build XMPP clients complying with the XMPP Compliance Suites 2021 for IM and Advanced Mobile. It comes with full API documentation, automatic tests and some 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 GStreamer 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.9 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_GSTREAMER                to enable audio/video over jingle (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

Examples

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.

Documentation

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

https://doc.qxmpp.org/

The API documentation of the master branch is also available:

https://doc.qxmpp.org/qxmpp-dev/

Supported Platforms

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

https://doc.qt.io/qt-5/supported-platforms.html

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:

https://github.com/qxmpp-project/qxmpp/issues

About

Cross-platform C++ XMPP client and server library

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 97.7%
  • CMake 1.8%
  • Other 0.5%