audiorecord(1) - NetBSD Manual Pages

AUDIORECORD(1)              NetBSD Reference Manual             AUDIORECORD(1)


NAME

     audiorecord - record audio files


SYNOPSIS

     audiorecord [-afhV] [-b balance] [-F format] [-c channels] [-d device]
     [-e encoding] [-i info] [-m monvol] [-P precision] [-p input] [-s rate]
     [-t time] [-v volume] [files]


DESCRIPTION

     The audiorecord program copies the audio devices to the named audiofile,
     or the standard output if no file is named.  The output file will contain
     either a Sun/NeXT audio header (default), a RIFF/WAVE audio header or no
     header at all.  For Sun output files when using a linear PCM encoding, we
     always output big-endian signed samples, possibly after converting these
     from little-endian and/or unsigned samples.  For RIFF/WAVE files, we al-
     ways use little-endian, signed samples, also converting if necessary
     (there is no support for RIFX output.)


OPTIONS

     The following options are available:

     -a      Append to the specified file, rather than overwriting.

     -b      Set the balance to balance.  This value must be between 0 and 63.

     -F      Set the output header format to format.  Currently supported for-
             mats are ``sun'', ``wav'' and ``none'' for Sun/NeXT audio, WAV
             and no header, respectively.

     -c      Set number of channels to channels.

     -d      Set the audio device to be device.  The default is /dev/sound.

     -e      Set encoding to either ``alaw'', ``ulaw'' or ``linear'', or any
             other value reported by audioctl encodings.  The default encoding
             is ``ulaw''.  If the output format is ``sun'', the file will con-
             tain slinear_be samples, if it is ``wav'', then slinear_le, inde-
             pendent of the argument to -e. Setting the argument to -e still
             may be important since it is used in an ioctl(2) call to the ker-
             nel to choose the kind of data provided.

     -f      Force.  Normally when appending to audiofiles using the -a op-
             tion, the sample rates must match.  The -f option will allow a
             discrepancy to be ignored.

     -h      Print a help message.

     -i      If the audio device cannot be opened, exit now rather than wait
             for it.

     -m      Set the monitor volume.

     -P      Set the precision.  This value is the number of bits per sample,
             and is normally either ``8'' or ``16'', though the values ``4'',
             ``24'' and ``32'' are also valid.

     -p      Set the output port to port.  The valid values of port are
             ``speaker'', ``headphone'' and ``line''.

     -s      Set the sampling rate.  This value is per-second.  Typical values
             are 8000, 44100 and 48000, which are the telephone, CD Audio and
             DAT Audio default sampling rates.

     -t      Sets the maximum amount of time to record.  Format is [hh:]mm:ss.

     -q      Be quiet.

     -V      Be verbose.

     -v      Set the volume (gain) to volume.  This value must be between 0
             and 255.


ENVIRONMENT

     AUDIOCTLDEVICE  the audio control device to be used.

     AUDIODEVICE     the audio device to be used.


SEE ALSO

     audioctl(1), audioplay(1), aria(4), audio(4), audioamd(4), auich(4),
     autri(4), auvia(4), clcs(4), clct(4), cmpci(4), eap(4), emuxki(4),
     esm(4), eso(4), ess(4), fms(4), gus(4), guspnp(4), neo(4), sb(4), sv(4),
     wss(4), yds(4), ym(4)


HISTORY

     The audiorecord program was first seen in SunOS 5.  It was first made
     available in NetBSD 1.4.  RIFF/WAVE support, and support for converting
     signed/unsigned and big/little-endian samples was first made available in
     NetBSD 1.6.


AUTHORS

     The audiorecord program was written by Matthew R. Green <mrg@eter-
     na.com.au>.


BUGS

     WAV big-endian samples are converted to little-endian, rather than a RIFX
     header being written.

NetBSD 1.6                     January 15, 2002                              2