gajim-remote(1)

1GAJIM-REMOTE(1)             User's Reference Manual            GAJIM-REMOTE(1)
2

NAME

4     gajim-remote — a remote control utility for gajim(1)
5

SYNOPSIS

7     gajim-remote command
8

DESCRIPTION

10     gajim-remote is a script to control and communicate with a running in‐
11     stance of gajim(1) by D-Bus.
12

OPTIONS

14     Available commands
15
16   account_info ⟨account⟩
17     Gets detailed info on a account
18
19   change_status [status] [message] [account]
20     Changes the status of account or accounts
21
22   check_gajim_running
23     Check if Gajim is running
24
25   contact_info ⟨jid⟩
26     Gets detailed info on a contact
27
28   get_status [account]
29     Returns current status (the global one unless account is specified)
30
31   get_status_message [account]
32     Returns current status message (the global one unless account is speci‐
33     fied)
34
35   get_unread_msgs_number
36     Returns number of unread messages
37
38   help [command]
39     Shows a help on specific command
40
41   list_accounts
42     Prints a list of registered accounts
43
44   list_contacts [account]
45     Prints a list of all contacts in the roster. Each contact appears on a
46     separate line
47
48   remove_contact ⟨jid⟩ [account]
49     Removes contact from roster
50
51   send_chat_message ⟨jid⟩ ⟨message⟩ [PGP key] [account]
52     Sends new chat message to a contact in the roster. Both OpenPGP key and
53     account are optional. If you want to set only 'account', without 'OpenPGP
54     key', just set 'OpenPGP key' to ''.
55
56   send_file ⟨file⟩ ⟨jid⟩ [account]
57     Sends file to a contact
58
59   send_groupchat_message ⟨room_jid⟩ ⟨message⟩ [account]
60     Sends new message to a groupchat you've joined.
61
62   send_single_message ⟨jid subject⟩ ⟨message⟩ [PGP key] [account]
63     Sends new single message to a contact in the roster. Both OpenPGP key and
64     account are optional. If you want to set only 'account', without 'OpenPGP
65     key', just set 'OpenPGP key' to ''.
66
67   send_xml ⟨xml⟩ [account]
68     Sends custom XML
69
70   set_priority ⟨priority⟩ [account]
71     Changes the priority of account or accounts
72
73   show_next_pending_event
74     Pops up a window with the next pending event
75
76   toggle_ipython
77     Shows or hides the ipython window
78
79   toggle_roster_appearance
80     Shows or hides the roster window
81

EXAMPLES

83     Open a URI of group chat gajim
84
85           $ gajim-remote handle_uri xmpp:gajim@conference.gajim.org?join
86
87     Send custom XML
88
89           $ gajim-remote send_xml $(cat filename.xml) "your@jabber.id"
90

AUTHORS

92     gajim-remote is written and maintained by Yann Leboulanger, and Denis
93     Fomin, with contributions and patches merged from many individuals around
94     the world.  See files AUTHORS and THANKS, for a complete list.
95

COPYRIGHT

97     Copyright (C) 2003-2022 Gajim Team
98
99     gajim-remote is free software; you can redistribute it and/or modify it
100     under the terms of the GNU General Public License as published by the
101     Free Software Foundation; version 3 only.
102
103     gajim-remote is distributed in the hope that it will be useful, but WITH‐
104     OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
105     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
106     more details.
107
108     You should have received a copy of the GNU General Public License along
109     with gajim-remote.  If not, see <https://www.gnu.org/licenses/>.
110

FEEDBACK

112     You can report bugs or feature requests in our bug tracker at
113     https://dev.gajim.org/gajim/gajim/issues or in the gajim-devel mailing
114     list; if you want to send us a patch, please do so in our bug tracker.
115     You can also find us in our chat room.
116

WWW

118     https://www.gajim.org/
119

XMPP

121     You are welcome to join us at gajim@conference.gajim.org
122

MAILING LIST

124     Below are public mailing lists on lists.gajim.org
125
126           https://lists.gajim.org/cgi-bin/listinfo/gajim-devel
127           https://lists.gajim.org/cgi-bin/listinfo/translators
128
129     More mailing lists at
130
131           https://lists.gajim.org/cgi-bin/listinfo
132

BUGS

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