audial (1nas)

Name

audial - generate or recognize touch tones for North American telephones

Synopsis

audial [-audio servername] [-volume 0-100] [-spacing milliseconds] [-pause milliseconds] [-duration milliseconds] dialstring

audial -recognize [-microphone] [-gain 0-100] [-time seconds]

Description

The audial program generates touch tones suitable for dialing a North American telephone. audial can also recognize touch tones and produce the corresponding string.

General Options

The following options may be used in either dial or recognition mode:

-audio servername: This option specifies the Network Audio System server on which the files should be played.

Dial Options

The following options may be used in dial mode:

-volume 0-100: This option specifies the volume at which the data should be played as a percentage of the maximum possible volume. The default is 100 percent.
-spacing milliseconds: This option specifies the number of milliseconds to wait in between each digit. The default is 100.
-pause milliseconds: This option specifies the number of milliseconds to wait whenever a comma (,) is used in a dial string. The default is 400.
-duration milliseconds: This option specifies the duration of each tone in milliseconds. The default is 100.

Dialing String

The following characters may be used in a dialing string:

0123456789*#: The corresponding touch tone is generated.
abcd: Tones representing the 4 “function” keys often found on a keypad are generated.
,: A blank tone whose length is specified by the -pause option is generated.

Any other characters are ignored.

Recognition Options

-recognize
Enables recognition mode. audial will attempt to recognize touch tones from the input device and output the corresponding character.

-microphone: Use microphone gain levels on the audio input device. If a microphone is plugged into the audio input jack, this option should be used.
-gain 0-100: This option specifies the input gain level. The default is 95.
-time seconds: This option specifies how long to attempt the recognition. The default is forever.