---
name: "audial"
section: "1x"
platform: "linux"
package: "nas"
version: "1.2p5-3"
release: "Debian 2.0 (Hamm)"
platforms: ["linux"]
url: "https://new.carta.tech/audial/1x"
---

# audial(1x)

generate or recognize touch tones for North American telephones

## 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.

## ENVIRONMENT VARIABLES

The following environment variables are used by *audial*:

- **AUDIOSERVER**

  This specifies the name of default audio server to contact if no name is  explicitly given on the command line.

- **DISPLAY**

  This specifies the name of an X Window System display that should be assumed to also have a corresponding Network Audio System server.

## SEE ALSO

nas(1)

## COPYRIGHT

Copyright 1993, 1994 Network Computing Devices, Inc.

## AUTHORS

Greg Renda, Network Computing Devices, Inc.\
 Kevin Martin, Network Computing Devices, Inc.