Chapter 3. Command reference

In addition to the standard Qt and KDE options, this program accepts three command line options, which are described here.

--offhook-stamp <FILE>

When this option is used, the given file (the full path of which must be given) will be set when the telephone handset is off hook. This can be used to prevent an automatic system shutdown during a telephone call when kb2kskype is integrated into a system (such as a MythTV box) that is configured to turn itself off when idle.

--status-script <SPEC>

This option can be used to set the Skype user's online status automatically by polling an arbitrary test script at 10 second intervals. SPEC is a comma-delimited argument consisting of two or more elements. The last element is the full path of the test script, and the preceding elements must be online status values recognized by Skype. The value set depends upon the exit value of the script: an exit value of 0 will cause the first value to be set; a value of 1 will cause the second to be set, and so forth. Here are some useful values to play with (from the Skype Public API).

ONLINEThe user is online and available to take calls.
AWAYThe user may be away from the telephone or busy with other work.
NAThe user is not available.
DNDThe user is in "do not disturb" mode
INVISIBLEThe user is invisible to others

Here is a sample use of this option that might set the status to ONLINE on a MythTV system when the TV frontend is active.

kb2kskype --status-script na,online,/path/to/checkscript.sh

The content of checkscript.sh might look something like this.

#!/bin/sh # Return 1 if the Myth frontend is running, otherwise 0 if [ -f /tmp/mythfrontend.pid ]; then echo Exists exit 1 else echo Does not exist exit 0

--debugmessages

Report all traffic to and from connected processes to the text box in the main window. Messages going to skype are in green. messages from skype are in red, and traffic related to the telbox is in blue. Use this option only for debugging purposes (unless you feel strongly that the main window needs a splash of colour).