gajim(1)

💬 gajim(1) — the manual page, bestie edition ✨

okay so you opened the gajim(1) manual page (that's the man page name, iykyk) and honestly? you're about to have a great time. let's go 💅

---

🌸 NAME 🌸

gajim — a fully-featured XMPP chat client 💖

---

✨ SYNOPSIS ✨

like, the shapes this command can take:

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 🦋

okay so gajim is literally aiming to be an easy to use and fully-featured XMPP client. that's the whole vibe. just chat with your friends or family, easily share pictures and thoughts, or discuss the news with your groups. no cap, it's that simple 🫶

and bestie, you can chat securely with End-to-End encryption via OMEMO or OpenPGP. the way that matters 😭🔐

gajim also integrates well with your other devices — simply continue conversations on your mobile device. main character energy across every screen you own 👑

now for the little lore drop: 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. (yes, "middle‐ ware" is written exactly like that in here, we don't fix it, we respect it 🙈)

for more information on the XMPP protocol see https://xmpp.org/about/. periodt.

---

🎀 OPTIONS 🎀

every single flag, no skips, we ate:

• -h, --help — show help options 💜
• -V, --version — show the application’s version 🏷️
• -q, --quiet — show only critical errors 🤫 like, keep it chill
• -v, --verbose — print XML stanzas and other debug information 🔍 full tea, every stanza
• -w, --warnings — show all warnings ⚠️
• *-l, --loglevel=SUBSYSTEM*=LEVEL — configure logging 📝

so the SUBSYSTEM is e.g. gajim.c.m, and LEVEL is one of (DEBUG, INFO, WARNING, ERROR, CRITICAL).

Example: gajim.c.m=DEBUG

• *-u, --user-profile=NAME* — use a profile to run multiple Gajim instances 🧚 like, one of you per profile, slay
• *-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 💬 go talk to someone bestie

---

📂 FILES 📂

the places gajim keeps its stuff:

• $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/-/work_items/. not me filing a bug report at 2am 🙈 — do it, they wanna know.

---

🫶 SUPPORT 🫶

you are welcome to join us at xmpp:gajim@conference.gajim.org?join. come hang out fr fr 💖

---

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

⚠️ like, actually read that part — no warranty, none, zero, the software is provided as-is and that's a real legal thing, not a vibe 💀

---

⭐ AUTHORS ⭐

Philipp Hörist, Daniel Brötzmann, Yann Leboulanger. icons, the lot of them 💅

---

and that's the whole page bestie!! 🌈 this was the gajim(1) manual, dated June 2025 — see you in the group chat 🎀💜