NAME

audiorecord − record an audio file

SYNOPSIS

audiorecord [ −a ] [ −f ] [ −v vol ] [ −t time ] [ −i info ] [ −d dev ] [ −p mic | line ] [ file ]

DESCRIPTION

audiorecord copies audio data from the audio device to a named audio file.  The output file will be prefixed by an audio file header.  The encoding information in this header is taken from the configuration of the audio device. 

Recording begins immediately and continues until a SIGINT signal (for example, CTRL-C) is received.  If the −t option is specified, audiorecord stops when the specified quantity of data has been recorded. 

If the audio device is unavailable (that is, another process currently has read access), audiorecord prints an error message and exits immediately. 

OPTIONS

−a Append: Append the data on the end of the named audio file. The audio encoding of the file must match the audio device configuration.

−f Force: When the −a flag is specified, the sample rate of the audio file must match the device configuration.  If the −f flag is also specified, sample rate differences are ignored, with a warning message printed on the standard error. 

−v vol Volume: The recording gain is set to the specified value before recording begins, and is reset to its previous level when audiorecord exits.  The vol argument is an integer value between 0 and 100, inclusive.  If this argument is not specified, the input volume will remain at the level most recently set by any process. 

−t time Time: The time argument specifies the maximum length of time to record.  Time can be specified as a floating-point value, indicating the number of seconds, or in the form: hh:mm:ss.dd, where the hour and minute specifications are optional.

−i info Information: The ‘information’ field of the output file header is set to the string specified by the info argument.  This option cannot be specified in conjunction with the −a argument. 

−d dev Device: The dev argument specifies an alternate audio device from which input should be taken.  If the −d option is not specified, /dev/audio is used as the default audio device. 

−p microphone | line
Input Port: Select the microphone (the default) or line input as the source of the audio input signal.  The port option can be abbreviated.  Not all audio cards support both input ports.  If the named port does not exist, this option is ignored. 

file File Specification: The named audio file is rewritten (or appended). If no filename is present, or if the special filename ‘−’ is specified, output is directed to the the standard output.

−?  Help: Print a command line usage message.

SEE ALSO

audioconvert(1), audioplay(1)

SunOS 5.1  —  Last change: 30 Sept 1992