GAJIM-REMOTE(1)

NAME
gajim-remote - a remote control utility for gajim(1)

SYNOPSIS
gajim-remote command

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

OPTIONS

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_gajim_running
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)

  get_unread_msgs_number
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

  list_accounts
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

  prefs_list
Lists all preferences and their values

  prefs_put key=value
Sets value of 'key' to 'value'.

  prefs_store
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

  show_next_pending_event
Pops up a window with the next pending event

  start_chat account
Opens 'Start Chat' dialog

  toggle_ipython
Shows or hides the ipython window

  toggle_roster_appearance
Shows or hides the roster window

EXAMPLES
Open a URI of group chat gajim

    $ gajim-remote handle_uri xmpp:gajim@conferenc.gajim.org?join

Send custom XML

    $ gajim-remote send_xml $(cat filename.xml) "your@jabber.id"

AUTHORS
-nosplit 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
Copyright (C) 2003-2013 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 <http://www.gnu.org/licenses/>.

FEEDBACK
You 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.

WWW
http://www.gajim.org/

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

MAILING LIST
Below are public mailing lists on lists.gajim.org

    http://lists.gajim.org/cgi-bin/listinfo/gajim-devel
    http://lists.gajim.org/cgi-bin/listinfo/translators

More mailing lists at

    http://lists.gajim.org/cgi-bin/listinfo

BUGS
Please submit bugs at https://trac.gajim.org/

SEE ALSO
gajim(1) gajim-history-manager(1)