audiorecord(1) - NetBSD Manual Pages

AUDIORECORD(1)          NetBSD General Commands Manual          AUDIORECORD(1)


NAME

     audiorecord -- record audio files


SYNOPSIS

     audiorecord [-afhqV] [-B buffersize] [-b balance] [-c channels]
                 [-d device] [-e encoding] [-F format] [-i info] [-m monvol]
                 [-P precision] [-p port] [-s rate] [-t time] [-v volume] file


DESCRIPTION

     The audiorecord program copies the audio device to the named audiofile
     or, if the file name is -, to the standard output.

     The output file will contain either a Sun/NeXT audio header, a RIFF/WAVE
     audio header or no header at all.  Sun output files using a linear PCM
     encoding are written with big-endian signed samples, possibly after con-
     verting these from little-endian or unsigned samples.  RIFF/WAVE files
     are written in little-endian, signed samples, also converting if neces-
     sary.  The default output is Sun/NeXT format, but if the output file file
     ends with a .wav file extension it will be written as RIFF/WAVE.


OPTIONS

     The following options are available:

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

     -B buffersize  Set the audio device read buffer size to buffersize.  The
                    default value is the record.buffer_size of the audio
                    device.

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

     -c channels    Set number of channels to channels.

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

     -e encoding    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 contain slinear_be samples, if it
                    is ``wav'', then slinear_le, independent 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 kernel to
                    choose the kind of data provided.

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

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

     -h             Print a help message.

     -i info        If supported by the -F format, add the string info to the
                    output header.

     -m monvol      Set the monitor volume.

     -P precision   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 port        Set the input port to port.  The valid values of port are
                    ``cd'', ``internal-cd'', ``mic'', and ``line''.

     -q             Be quiet.

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

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

     -V             Be verbose.

     -v volume      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.


EXAMPLES

     Record CD quality audio to a WAVE file:
           audiorecord -c 2 -e slinear_le -P 16 -s 44100 recording.wav


SEE ALSO

     audioctl(1), audioplay(1), aria(4), audio(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), sparc/audioamd(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@eterna.com.au>.


BUGS

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

NetBSD 10.99                    March 25, 2021                    NetBSD 10.99