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

   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

   help [command]
     Shows a help on specific command

   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

   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

   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

     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-2018 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 <https://www.gnu.org/licenses/>.

FEEDBACK

     You can report bugs or feature requests in our bug tracker at
     https://dev.gajim.org/gajim/gajim/issues 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

     https://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

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

     More mailing lists at

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

BUGS

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

SEE ALSO

     gajim(1) gajim-history-manager(1)