gajim(1) Manual gajim(1)

gajim - a fully-featured XMPP chat client

gajim -h

gajim --start-chat

gajim [-V] [-q] [-v] [-w] [-l subsystem=level] [-u name] [-c directory] [--configure path] [--export-settings path] [--gdebug] [--cprofile]

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. Chat securely with End-to-End encryption via OMEMO or OpenPGP. gajim integrates well with your other devices: simply continue conversations on your mobile device.

XMPP is the Extensible Messaging and Presence Protocol, a set of open technologies for instant messaging, presence, multi-party chat, voice and video calls, collaboration, lightweight middle‐ ware, content syndication, and generalized routing of XML data. For more information on the XMPP protocol see https://xmpp.org/about/.

Show help options
Show the application’s version
Show only critical errors
Print XML stanzas and other debug information
Show all warnings
Configure logging

SUBSYSTEM e.g. gajim.c.m

LEVEL (DEBUG, INFO, WARNING, ERROR, CRITICAL)

Example: gajim.c.m=DEBUG

Use a profile to run multiple Gajim instances
Set configuration directory
Configure Gajim with values from a .json file
Export settings to a .json file
Sets an environment variable so GLib debug messages are printed
Profile application with cprofile
Start a new chat

$XDG_CACHE_HOME/gajim/
The directory for cached data.
$XDG_CONFIG_HOME/gajim/
The directory where settings and configurations are stored.
$XDG_DATA_HOME/gajim/
The directory where all persistent data, e.g. the message database, is stored.

Please submit bugs at https://dev.gajim.org/gajim/gajim/issues.

You are welcome to join us at xmpp:gajim@conference.gajim.org?join.

gajim is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; version 3 only.

gajim is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Philipp Hörist, Daniel Brötzmann, Yann Leboulanger.

June 2025