xphone(1) GNU X phone icon

SYNOPSIS

xphone [ -hvs --bellcommand <unix command> --idlecommand <unix command &> --ringcommand <unix command &> --geometry <position> --iforeground <color> --ibackground <color> --rforeground <color> --rbackground <color> --idleimage <X11 bitmap file> --ringimage <X11 bitmap file> --version ]

DESCRIPTION

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.

AUTHOR

Eric M Ludlam <[email protected]>

BUGS

Report bugs to <[email protected]>. This system has never been tested in a high volume situation due to my limited resources.

COPYRIGHT

Copyright © 1995, 1996 Eric M. Ludlam for Free Software Foundation.

AVAILABILITY

The newest version of xphone can be found within the etalk distribution. As of the writing of this manual, it can be found on ftp.ultranet.com:/pub/zappo/gtalk-*.tar.gz