tkabber-remote - remotely control a running instance of Tkabber
Contents
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.
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-profileprofile
Sets an active network proxy profile by its name. The profile must be already configured.
set-statusstatus [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.
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.
Name
tkabber-remote - remotely control a running instance of Tkabber
Options
-useruser
Makes the program control Tkabber run by the specified user instead of the user who runs tkabber-remote.
-pidPID
Makes the program control Tkabber process with the specified identifier (PID) instead of all the
instances found.
See Also
tkaber(1) tkabber-plugins(7)
Synopsis
tkabber-remote [options] -eval scripttkabber-remote [options] -command command
