audiorecord(1) - NetBSD Manual Pages

Command: Section: Arch: Collection:  
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 9.99 March 25, 2021 NetBSD 9.99
Powered by man-cgi (2021-06-01). Maintained for NetBSD by Kimmo Suominen. Based on man-cgi by Panagiotis Christias.