xsoundsentry(1X)														  xsoundsentry(1X)

NAME

       xsoundsentry - Visual bell monitor

SYNOPSIS

       xsoundsentry [options]

OPTIONS

       The following list contains general usage options for the xsoundsentry command: Specifies the number of times an action will occur when the
       terminal or workstation bell sounds.  The default value is 1.  Specifies the length of time that must pass between bell events.	If a  bell
       event  occurs  within  the specified suppress time after a previous bell action, it will be ignored.  The default suppress time is 200 mil-
       liseconds.

       The following options support indicator modes: Causes a screen refresh, which appears as a flashing of the  screen.   If  you  include  the
       -refreshColor  option,  you  can specify a color to be used in the refresh action.  If you include the -refreshGeom option, you can specify
       the portion of the screen to be refreshed.  Causes a command to be executed whenever a bell event occurs.  Use the -prog option to  specify
       the  command  you  want	to be executed.  Displays a small sound icon window that flashes whenever a bell event occurs. Use the -fg and -bg
       options to specify the foreground and background colors for the icon window.

DESCRIPTION

       The xsoundsentry utility provides visual indications of bell events that occur in the X server.	These bell events  result  from  calls	to
       XBell.  (See XBell(3X11)).  This utility is useful for people with hearing disabilities and well as those who work in noisy environments.

RESOURCES

       The  xsoundsentry command has the following general resources: Specifies the default behavior of the utility.  The keyword specifier can be
       Refresh, Bitmap, or Command.  Specifies the length of time that must pass between bell events.  If a bell event occurs within the specified
       suppress  time  after  a previous bell action, it will be ignored.  The default suppress time is 200 milliseconds.  Specifies the number of
       times an action will occur when the terminal or workstation bell sounds.  The default value is 1.

       The xsoundsentry command has the following refresh action resources: Specifies the color to be used in the refresh action.   Specifies  the
       portion	of  the  screen to be refreshed.  Specifies the length of time the refresh window will be displayed.  The default value is 50 mil-
       liseconds.

       The xsoundsentry command has the following command action resource: Causes the specified command (string) to be executed  whenever  a  bell
       event occurs.

       The  xsoundsentry command has the following bitmap action resource: Specifies the length of time the refresh window will be displayed.  The
       default value is 50 milliseconds.

EXAMPLES

       This example causes a red flash on the screen whenever a bell event occurs: xsoundsentry -refresh -refreshColor redo This example causes  a
       box  to	flash  in the center of a 1280x1024 screen: xsoundsentry -refreshGeom 800x800+240_112 This example executes the echo hello command
       whenever a bell event occurs: xsoundsentry -command -prog 'echo hello'

SEE ALSO

       XBell(3X11)

																  xsoundsentry(1X)