.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "gajim" "1" "June 2025" "" "Manual"
.SH NAME
gajim \- a fully\-featured XMPP chat client
.SH SYNOPSIS
gajim \-h
.PD 0
.P
.PD
gajim \-\-start\-chat
.PD 0
.P
.PD
gajim [\-V] [\-q] [\-v] [\-w] [\-l subsystem=level] [\-u name] [\-c
directory] [\-\-configure path] [\-\-export\-settings path] [\-\-gdebug]
[\-\-cprofile]
.SH DESCRIPTION
\f[B]gajim\f[R] 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.
.PP
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/.
.SH OPTIONS
.TP
\f[CR]\-h, \-\-help\f[R]
Show help options
.TP
\f[CR]\-V, \-\-version\f[R]
Show the application\[cq]s version
.TP
\f[CR]\-q, \-\-quiet\f[R]
Show only critical errors
.TP
\f[CR]\-v, \-\-verbose\f[R]
Print XML stanzas and other debug information
.TP
\f[CR]\-w, \-\-warnings\f[R]
Show all warnings
.TP
\f[CR]\-l, \-\-loglevel=SUBSYSTEM=LEVEL\f[R]
Configure logging
.RS
.PP
SUBSYSTEM e.g.\ gajim.c.m
.PD 0
.P
.PD
LEVEL (DEBUG, INFO, WARNING, ERROR, CRITICAL)
.PP
Example: gajim.c.m=DEBUG
.RE
.TP
\f[CR]\-u, \-\-user\-profile=NAME\f[R]
Use a profile to run multiple Gajim instances
.TP
\f[CR]\-c, \-\-config\-path=PATH\f[R]
Set configuration directory
.TP
\f[CR]\-\-configure=PATH\f[R]
Configure Gajim with values from a .json file
.TP
\f[CR]\-\-export\-settings=PATH\f[R]
Export settings to a .json file
.TP
\f[CR]\-\-gdebug\f[R]
Sets an environment variable so GLib debug messages are printed
.TP
\f[CR]\-\-cprofile\f[R]
Profile application with cprofile
.TP
\f[CR]\-\-start\-chat\f[R]
Start a new chat
.SH FILES
.TP
$XDG_CACHE_HOME/gajim/
The directory for cached data.
.TP
$XDG_CONFIG_HOME/gajim/
The directory where settings and configurations are stored.
.TP
$XDG_DATA_HOME/gajim/
The directory where all persistent data, e.g.\ the message database, is
stored.
.SH BUGS
Please submit bugs at https://dev.gajim.org/gajim/gajim/issues.
.SH SUPPORT
You are welcome to join us at xmpp:gajim\[at]conference.gajim.org?join.
.SH COPYRIGHT
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.
.PP
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.
.SH AUTHORS
Philipp Hörist, Daniel Brötzmann, Yann Leboulanger.