[[TOC]]

Gajim

A fully-featured XMPP chat client.

Gajim aims to be an easy to use and fully-featured XMPP client. Just chat with your friends or family, easily share pictures and thoughts or discuss the news with your groups.

Requirements

Runtime Requirements

• libadwaita (>=1.7.0)
• cairo (>=1.16.0)
• cryptography (>=43.0.0)
• css-parser
• emoji (>=2.6.0)
• GLib (>=2.80.0)
• Gtk4 (>=4.17.5)
• GtkSourceView5
• GStreamer
• gst-plugins-base
• keyring
• nbxmpp (>=7.4.0)
• omemo-dr (>=1.2.0)
• packaging
• httpx2
• h2
• Pango (>=1.50.0)
• Pillow (>=9.1.0)
• precis_i18n
• pysequoia (>=0.1.33)
• pycairo
• PyGObject (>=3.53.0)
• Python (>=3.12)
• qrcode (>=7.3.1)
• socksio
• SQLAlchemy (>=2.0.0)
• sqlite (>=3.35.0)
• truststore
• pystray (Only on Windows)
• PyWinRT (Only on Windows)
• windows-toasts (Only on Windows)

Optional Runtime Requirements

• D-Bus running to have gajim-remote working
• sentry-sdk for Sentry error reporting to gitlab.com (users decide whether to send reports or not)
• libspelling and hunspell-LANG where lang is your locale eg. en, fr etc
• libsecret for GNOME Keyring or KDE support as password storage
• GUPnP-IGD for better NAT traversing
• NetworkManager for network lose detection
• GeoClue for sharing your location
• distro to get accurate information about the used operating system (name, version)

Rich Previews (Images and Voice Messages)

• gst-libav
• gst-plugins-good
• gst-plugins-bad
• gst-plugins-rs

Build Requirements

• setuptools (>=65.0.0)
• gettext

To build Gajim a PEP517 build frontend like pip (https://pip.pypa.io/en/stable/) or build (https://pypa-build.readthedocs.io/en/stable/) must be used.

The build frontend takes care of installing all python build requirements. Beware gettext is not a python library and cannot be installed by the build frontend.

Building

Building the metadata files and translation

$ uv run ./make.py build -h

usage: make.py build [-h] [--dist {unix,flatpak,flatpak-nightly,win}]

Afterwards metadata files can be found in dist/metadata folder.

Building the wheel

Using build

python -m build -w

Using uv

uv build

Installing

uv pip install dist/name_of_wheel.whl

Installing the metadata files (Unix only)

$ uv run ./make.py install -h

usage: make.py install [-h] [--dist {unix,flatpak,flatpak-nightly}] [--prefix PREFIX]

options:
  -h, --help            show this help message and exit
  --dist {unix,flatpak,flatpak-nightly}
                        Distribution
  --prefix PREFIX       The path prefix for installation (e.g. "/usr")

Tests

• uv run pytest
• uv run pytest ./test/gtk/gui_file.py (for testing GUI files)

Packages and install instructions

Packages

• Arch Linux
• Debian
• Fedora
• FreeBSD
• openSUSE
• Ubuntu

Flatpak

see README

Snapshots

• Daily Linux
• Daily Windows

Mac

see Wiki

Developing

The easiest way to run the development version is to use uv

uv run gajim --user-profile dev

Windows

see README

Miscellaneous

Debugging

Execute gajim with --verbose

Links

• FAQ
• Wiki

That is all, enjoy!

(C) 2003-2026 The Gajim Team https://gajim.org

We use original art and parts of sounds and other art from Psi, Gossip, Gnomebaker, Gaim and some icons from various gnome-icons (mostly Dropline Etiquette) we found at art.gnome.org. If you think we're violating a license please inform us. Thank you.