NAMEgajim-remote - a remote control utility for gajim(1)
DESCRIPTIONis a script to control and communicate with a running instance of gajim(1) by D-Bus.
- Available commands
account_info Aq accountGets detailed info on a account
add_contact Ao jid Ac Bq accountAdds contact to roster
change_avatar Ao picture Ac Bq accountChange the avatar
change_status Bo status Bc Bo message Bc Bq accountChanges the status of account or accounts
check_gajim_runningCheck if Gajim is running
contact_info Aq jidGets detailed info on a contact
get_status Bq accountReturns current status (the global one unless account is specified)
get_status_message Bq accountReturns current status message (the global one unless account is specified)
get_unread_msgs_numberReturns number of unread messages
handle_uri Ao uri Ac Bo account Bc Bq messageHandle a xmpp:/ uri
help Bq commandShows a help on specific command
join_room Ao room Ac Bo nick Bc Bo password Bc Bq accountJoin a MUC room
list_accountsPrints a list of registered accounts
list_contacts Bq accountPrints a list of all contacts in the roster. Each contact appears on a separate line
open_chat Ao jid Ac Bo account Bc Bq messageShows the chat dialog so that you can send messages to a contact
prefs_del Aq keyDeletes a preference item
prefs_listLists all preferences and their values
prefs_put Aq key=valueSets value of 'key' to 'value'.
prefs_storeWrites the current state of Gajim preferences to the .config file
remove_contact Ao jid Ac Bq accountRemoves contact from roster
send_chat_message Ao jid Ac Ao message Ac Bo pgp key Bc Bq accountSends 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 Ao file Ac Ao jid Ac Bq accountSends file to a contact
send_groupchat_message Ao room_jid Ac Ao message Ac Bq accountSends new message to a groupchat you've joined.
send_single_message Ao jid subject Ac Ao message Ac Bo pgp key Bc Bq accountSends 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 Ao xml Ac Bq accountSends custom XML
set_priority Ao priority Ac Bq accountChanges the priority of account or accounts
show_next_pending_eventPops up a window with the next pending event
start_chat Aq accountOpens 'Start Chat' dialog
toggle_ipythonShows or hides the ipython window
toggle_roster_appearanceShows or hides the roster window
EXAMPLESOpen a URI of group chat gajim
$ gajim-remote handle_uri xmpp:email@example.com?join
Send custom XML
$ gajim-remote send_xml $(cat filename.xml ) Qq firstname.lastname@example.org
AUTHORSAn -nosplit is written and maintained by An Yann Leboulanger , and An Denis Fomin , with contributions and patches merged from many individuals around the world. See files AUTHORS and THANKS for a complete list.
COPYRIGHTCopyright (C) 2003-2015 Gajim Team
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.
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 . If not, see <www.gnu.org/licenses>.
FEEDBACKYou can report bugs or feature requests in our bug tracker at trac.gajim.org 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.
XMPPYou are welcome to join us at email@example.com
MAILING LISTBelow are public mailing lists on lists.gajim.org
More mailing lists at