NAME

       tkabber-remote - remotely control a running instance of Tkabber

SYNOPSIS

       tkabber-remote [options] -eval script

       tkabber-remote [options] -command command

DESCRIPTION

       Tkabber  is  a  GUI  client for XMPP (Jabber) instant messaging protocol. It provides full
       support for basic XMPP specifications as well as many extensions (XEPs)  including  multi-
       user  conferencing,  file  transfers,  extensive  handling of privacy lists and much more.
       Tkabber is written in Tcl/Tk and thus is easily extensible.

       The tkabber-remote program can be used to remotely control a running instance  of  Tkabber
       by sending it predefined commands or Tcl scripts for execution.

       This manual page was written for the Debian distribution because the original program does
       not have a manual page.

OPTIONS

       -user user
              Makes the program control Tkabber run by the specified user instead of the user who
              runs tkabber-remote.

       -pid PID
              Makes  the  program  control  Tkabber  process  with the specified identifier (PID)
              instead of all the instances found.

EXECUTING SCRIPTS

       To make a running  Tkabber  instance  execute  an  arbitrary  Tcl  script  use  the  -eval
       command-line option followed by that script's text.  (The script's text must form a single
       argument passed to this program, so proper quoting should  be  used,  if  necessary,  when
       calling tkabber-remote from a shell).

       Executing  a  script prints the PID of the process which received and executed the script,
       and then the string representation of the Tcl value the script returned.

EXECUTING COMMANDS

       The commands which can be used with the -command command-line options are:

       list-commands
              Prints a list of all the commands supported by the -command command-line option.

       set-proxy-profile profile
              Sets an active network proxy profile by its name.   The  profile  must  be  already
              configured.

       set-status status [textstatus]
              Sets the availability (presence) status of the user.

              Available status codes are:

              available
                     The user is available.

              away   The user is temporarily away.

              chat   The user is actively interested in chatting.

              dnd    The user does not want to be disturbed (dnd = "Do Not Disturb").

              xa     The user is away for an exteneded period of time (xa = "eXtended Away").

              The  optional  textstatus  argument  can  be  used  to  set a textual message which
              accompanies the availability status.   (The  message's  text  must  form  a  single
              argument,   so   proper   quoting  should  be  used,  if  necessary,  when  calling
              tkabber-remote from a shell).

              Note that sending this command while the receiving Tkabber instance is offline (not
              connected)  will  not  make  it  connect;  the  status  will merely be recorded and
              announced when Tkabber goes online.

       Executing a command prints the PID of the process which received and executed the command,
       and then the string representation of the Tcl value the command returned.

SEE ALSO

       tkaber(1) tkabber-plugins(7)

AUTHOR

       This  manual page was written by Konstantin Khomoutov <flatworm@users.sourceforge.net> for
       the Debian system (but may be used by others).  Copying and distribution of this document,
       with  or  without  modification,  are permitted in any medium without royalty provided the
       copyright notice and this notice are preserved.