Index for Section 1X

Alphabetical listing for X

Bottom of page

xsoundsentry(1X)
NAME
  xsoundsentry - Visual bell monitor

SYNOPSIS
  xsoundsentry [options]

OPTIONS
  The following list contains general usage options for the xsoundsentry
  command:

  -repeat value
      Specifies the number of times an action will occur when the terminal or
      workstation bell sounds.	The default value is 1.

  -suppress milliseconds
      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.

  The following options support indicator modes:

  -refresh [ -refreshColor color ] [ -refreshGeom geometry ]
      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.

  -command [ -prog command ]
      Causes a command to be executed whenever a bell event occurs.  Use the
      -prog option to specify the command you want to be executed.

  -bitmap [ -fg color ] [ -bg color ]
      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:

  action: keyword
      Specifies the default behavior of the utility.  The keyword specifier
      can be Refresh, Bitmap, or Command.

  bellSuppressTime: milliseconds
      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.

  bellRepeat: count
      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:

  refreshColor: color
      Specifies the color to be used in the refresh action.

  refreshGeom: geometry
      Specifies the portion of the screen to be refreshed.

  repeatPause: milliseconds
      Specifies the length of time the refresh window will be displayed.  The
      default value is 50 milliseconds.

  The xsoundsentry command has the following command action resource:

  command: string
      Causes the specified command (string) to be executed whenever a bell
      event occurs.

  The xsoundsentry command has the following bitmap action resource:

  repeatPause: milliseconds
      Specifies the length of time the refresh window will be displayed.  The
      default value is 50 milliseconds.

EXAMPLES
   1.  This example causes a red flash on the screen whenever a bell event
       occurs:
	    xsoundsentry -refresh -refreshColor redo

   2.  This example causes a box to flash in the center of a 1280x1024
       screen:
	    xsoundsentry -refreshGeom 800x800+240_112

   3.  This example executes the echo hello command whenever a bell event
       occurs:
	    xsoundsentry -command -prog 'echo hello'

SEE ALSO
  XBell(3X11)

Index for Section 1X

Alphabetical listing for X

Top of page