xsoundsentry(1X) — Commands
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’