xphone1

Usage

Overview

xphone is a simple program which creates a window on an X display which contains a phone icon. If the system uses the GNU talk daemon, then this phone icon will ring whenever someone attempts to make a talk connection to you. When this happens, the phone icon will change, and the terminal will beep.

Command line switches are:

--bellcommand <unix command line>

This option provides a hook into how one wishes a "bell" to be sounded. Setting this command to something like "play ring.au" will play a recorded sound instead of calling xbell. Any command which can be run from the system(3) call can be used.

--idlecommand <unix command>

Provide an alternate unix command to execute when clickon on the idle xphone icon. The default is "gtalk &". Be sure to append an & to the command being executed. Any command which can be run from the system(3) call can be used.

--ringcommand <unix command>

Provide an alternate unix command to execute when clickon on the idle xphone icon. The default is "gtalk -r &". Be sure to append an & to the command being executed. Any command which can be run from the system(3) call can be used.

--geometry

Change the default location of the window when it first starts up. Only the position is used, size is determined by the icon used.

-h, --help

Print process help.

--ifg --iforeground <color>

The foreground color to use on the idle phone icon.

--ibg --ibackground <color>

The background color to use on the idle phone icon.

--idleimage <X11 bitmap file>

A file which contains an X11 bitmap file created by the bitmap(1) command which represents an idle phone status.

--rfg --rforeground <color>

The foreground color to use on the ringing phone icon.

--rbg --rbackground <color>

The background color to use on the ringing phone icon.

--ringimage <X11 bitmap file>

A file which contains an X11 bitmap file created by the bitmap(1) command which indicates a ringing phone status.

-s --silent

Do not print out ring information to stdout.

-v, --verbose

Print out verbose information, or verbose syslog information.

--version

Print out the current version of xphone.

X resources

xphone.geometry

Default position at start up.

xphone.title

Name of the window in the window managers title bar

xphone.iconname

Name placed under the icon

xphone.ringcommand

Alternate command used to make a ringing sound

xphone.idle.clickcommand

Alternate program to run when clicking on xphone when no calls are pending. Default is "gtalk".

xphone.ring.clickcommand

Alternate program to run when clicking on xphone when calls are pending. Default is "gtalk -r".

xphone.idle.foreground

Foreground color of idle phone

xphone.idle.background

Background color of idle phone

xphone.ring.foreground

Foreground color of ringing phone

xphone.ring.background

Background color of ringing phone

xphone.idle.bitmap

Alternate bitmap for idle phone

xphone.ring.bitmap

Alternate bitmap for ringing phone @end table

Files and environment

~/.ringer

This is the "ringer" file which gtalkd reads. it holds a definition of a UDP socket address in host byte order. Gtalkd then sends the announcement to this socket instead of to the terminal associated with the user. If the definition in this file describes a host other than the one the talk daemon is on (a common occurrence in a network which uses NFS heavily), then a LOOK_HERE message is returned.

$DISPLAY

This variable describes an X display xphone will attempt to use when initializing the X interface.