gajim-remote — a"> Man pages sections > man1 > gajim-remote


GAJIM-REMOTE(1) General Commands Manual (urm) GAJIM-REMOTE(1)


gajim-remotea remote control utility for gajim(1)


gajim-remote command


gajim-remote is a script to control and communicate with a running instance of gajim(1) by D-Bus.


Available commands

account_info ⟨account⟩

Gets detailed info on a account

add_contact ⟨jid⟩ [account]

Adds contact to roster

change_avatar ⟨picture⟩ [account]

Change the avatar

change_status [status] [message] [account]

Changes the status of account or accounts


Check if Gajim is running

contact_info ⟨jid⟩

Gets detailed info on a contact

get_status [account]

Returns current status (the global one unless account is specified)

get_status_message [account]

Returns current status message (the global one unless account is specified)


Returns number of unread messages

handle_uri ⟨uri⟩ [account] [message]

Handle a xmpp:/ uri

help [command]

Shows a help on specific command

join_room ⟨room⟩ [nick] [password] [account]

Join a MUC room


Prints a list of registered accounts

list_contacts [account]

Prints a list of all contacts in the roster. Each contact appears on a separate line

open_chat ⟨jid⟩ [account] [message]

Shows the chat dialog so that you can send messages to a contact

prefs_del ⟨key⟩

Deletes a preference item


Lists all preferences and their values

prefs_put ⟨key=value⟩

Sets value of 'key' to 'value'.


Writes the current state of Gajim preferences to the .config file

remove_contact ⟨jid⟩ [account]

Removes contact from roster

send_chat_message ⟨jid⟩ ⟨message⟩ [pgp key] [account]

Sends new chat message to a contact in the roster. Both OpenPGP key and account are optional. If you want to set only 'account', without 'OpenPGP key', just set 'OpenPGP key' to ''.

send_file ⟨file⟩ ⟨jid⟩ [account]

Sends file to a contact

send_groupchat_message ⟨room_jid⟩ ⟨message⟩ [account]

Sends new message to a groupchat you've joined.

send_single_message ⟨jid subject⟩ ⟨message⟩ [pgp key] [account]

Sends new single message to a contact in the roster. Both OpenPGP key and account are optional. If you want to set only 'account', without 'OpenPGP key', just set 'OpenPGP key' to ''.

send_xml ⟨xml⟩ [account]

Sends custom XML

set_priority ⟨priority⟩ [account]

Changes the priority of account or accounts


Pops up a window with the next pending event

start_chat ⟨account⟩

Opens 'Start Chat' dialog


Shows or hides the ipython window


Shows or hides the roster window


Open a URI of group chat gajim
$ gajim-remote handle_uri
Send custom XML
$ gajim-remote send_xml $(cat filename.xml) “”


gajim-remote is written and maintained by Yann Leboulanger, and Denis Fomin, with contributions and patches merged from many individuals around the world. See files AUTHORS and THANKS, for a complete list. Copyright (C) 2003-2015 Gajim Team
gajim-remote 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-remote 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.
You should have received a copy of the GNU General Public License along with gajim-remote. If not, see <>.


You can report bugs or feature requests in our bug tracker at or in the 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.



You are welcome to join us at


Below are public mailing lists on
More mailing lists at


Please submit bugs at


gajim(1) gajim-history-manager(1)
August 26, 2015 UNIX