Reference

gajim(1)

a fully-featured XMPP chat client

NAME

gajim - a fully-featured XMPP chat client

SYNOPSIS

gajim -h

gajim --start-chat

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

DESCRIPTION

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/.

OPTIONS

-h, --help

Show help options

-V, --version

Show the application’s version

-q, --quiet

Show only critical errors

-v, --verbose

Print XML stanzas and other debug information

-w, --warnings

Show all warnings

-l, --loglevel=SUBSYSTEM=LEVEL

Configure logging

SUBSYSTEM e.g. gajim.c.m

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

Example: gajim.c.m=DEBUG

-u, --user-profile=NAME

Use a profile to run multiple Gajim instances

-c, --config-path=PATH

Set configuration directory

--configure=PATH

Configure Gajim with values from a .json file

--export-settings=PATH

Export settings to a .json file

--gdebug

Sets an environment variable so GLib debug messages are printed

--cprofile

Profile application with cprofile

--start-chat

Start a new chat

FILES

$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.

BUGS

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

SUPPORT

You are welcome to join us at xmpp:[email protected]?join.

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.

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.

AUTHORS

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

History

--config-path since Debian 8 (Jessie); --configure since Arch Linux 2026-11-01; --cprofile since Debian 13 (Trixie); --export-settings since Arch Linux 2026-11-01; --gdebug since Debian 13 (Trixie); --loglevel since Debian 13 (Trixie); --quiet since Debian 8 (Jessie); --start-chat since Debian 13 (Trixie); --user-profile since Arch Linux 2026-11-01; --version since Debian 13 (Trixie); --warnings since Debian 10 (Buster); -V since Debian 13 (Trixie); -c since Debian 8 (Jessie); -l since Debian 13 (Trixie); -q since Debian 8 (Jessie); -u since Arch Linux 2026-11-01; -w since Debian 10 (Buster).

--profile until Debian 13 (Trixie); --separate until Debian 13 (Trixie); -p until Debian 13 (Trixie); -s until Debian 13 (Trixie).