gajim.1 3.8 KB
Newer Older
André's avatar
André committed
1
.Dd January 21, 2018
2 3 4 5 6 7 8 9 10 11 12
.Dt GAJIM 1 URM
.Os UNIX
.Sh NAME
.Nm gajim
.Nd a Jabber/XMPP client
.Sh SYNOPSIS
.Nm
.Fl h
.Nm
.Op Fl q
.Op Fl v
Philipp Hörist's avatar
Philipp Hörist committed
13
.Op Fl w
14 15
.Op Fl l Ar subsystem=level
.Op Fl p Ar name
Philipp Hörist's avatar
Philipp Hörist committed
16
.Op Fl s
17 18 19 20 21 22 23 24 25 26 27 28 29 30
.Op Fl c Ar directory
.Sh DESCRIPTION
.Nm
is a Jabber/XMPP client written in Python and GTK+.
.Nm
works nicely with GNOME, yet it does not require it to run.
.Nm
is designed for novice and advanced users as one, as well for XMPP
server admins.
.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 middleware, content
syndication, and generalized routing of XML data. For more information
31
on the XMPP protocol see <https://xmpp.org/about-xmpp/>.
32 33 34 35 36 37
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl h Fl Fl help
Show help options
.It Fl q Fl Fl quiet
Show only critical errors
Philipp Hörist's avatar
Philipp Hörist committed
38 39
.It Fl s Fl Fl separate
Separate profiles completely (even history db and plugins)
40 41
.It Fl v Fl Fl verbose
Print xml stanzas and other debug information
Philipp Hörist's avatar
Philipp Hörist committed
42 43
.It Fl w Fl Fl warnings
Show all GTK warnings with traceback
44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65
.It Fl l Fl Fl loglevel Em subsystem=level Bq , Em subsystem=level Bq Em ...
Configure logging system.
Subsystem can be
.Em gajim.interface ,
.Em gajim.c.connection ,
.Em .nbxmpp.client_nb ,
etc.
Level can be
.Em DEBUG ,
.Em INFO ,
.Em WARNING ,
.Em ERROR
or
.Em CRITICAL .
.It Fl p Fl Fl profile Em name
Run
.Nm
using
.Pa config.name
in configuration directory
.It Fl c Fl Fl config-path Em directory
Where to look for configuration files
Yann Leboulanger's avatar
Yann Leboulanger committed
66
.El
67 68
.Sh FILES
.Bl -tag -width Ds
69
.It $XDG_CACHE_HOME/gajim/cache.db
70
Cache database file of transports, caps, roster entry, and roster group.
71
.It $XDG_CACHE_HOME/gajim/avatars/
72
Cache directory of avatars.
73
.It $XDG_CACHE_HOME/gajim/vcards/
74
Cache directory of vCards (virtual cards).
75
.It $XDG_CONFIG_HOME/gajim/
76 77 78
The config-path used when
.Op Fl c
is not specified.
79
.It $XDG_DATA_HOME/gajim/certs/
80
Directory where certificates are stored.
81
.It $XDG_DATA_HOME/gajim/logs.db
82
The history database log file.
Philipp Hörist's avatar
Philipp Hörist committed
83 84
For more information on database logs see
<https://dev.gajim.org/gajim/gajim/wikis/development/LogsDatabase>.
85 86 87 88 89
.El
.Sh AUTHORS
.An -nosplit
.Nm
is written and maintained by
Philipp Hörist's avatar
Philipp Hörist committed
90
.An Yann Leboulanger 
91
and
Philipp Hörist's avatar
Philipp Hörist committed
92
.An Philipp Hörist ,
93
with contributions and patches merged from many individuals around the world.
Philipp Hörist's avatar
Philipp Hörist committed
94
See the About Dialog for a complete list.
95
.Sh COPYRIGHT
André's avatar
André committed
96
Copyright (C) 2003-2019 Gajim Team
97 98 99 100 101 102 103 104 105
.Pp
.Nm
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
.Nm
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.
.Pp
You should have received a copy of the GNU General Public License along with
.Nm .
106
If not, see <https://www.gnu.org/licenses/>.
107 108
.Sh FEEDBACK
You can report bugs or feature requests in our bug tracker at
Philipp Hörist's avatar
Philipp Hörist committed
109
.Em https://dev.gajim.org/gajim/gajim/issues
110 111 112 113 114
or in the
.Em gajim-devel
mailing list; if you want to send us a patch, please do so in our bug tracker.
You can also find us in our chat room.
.Sh WWW
115
https://www.gajim.org/
116 117 118 119 120
.Sh XMPP
You are welcome to join us at gajim@conference.gajim.org
.Sh MAILING LIST
Below are public mailing lists on lists.gajim.org
.Bd -literal -offset indent
121 122
https://lists.gajim.org/cgi-bin/listinfo/gajim-devel
https://lists.gajim.org/cgi-bin/listinfo/translators
123 124 125 126
.Ed
.Pp
More mailing lists at
.Bd -literal -offset indent
127
https://lists.gajim.org/cgi-bin/listinfo
128 129 130 131
.Ed
.Sh BUGS
Please submit bugs at
.Bd -literal -offset indent
Philipp Hörist's avatar
Philipp Hörist committed
132 133 134
https://dev.gajim.org/gajim/gajim/issues
https://dev.gajim.org/gajim/gajim-plugins
https://dev.gajim.org/gajim/python-nbxmpp
135 136 137 138
.Ed
.Sh SEE ALSO
.Xr gajim-remote 1
.Xr gajim-history-manager 1