xenial (1) ossrecord.1.gz

NAME

       ossrecord - Open Sound System recording program.

SYNOPSIS

       ossrecord [-ORhlv] [-F cntname | ? ] [ -c channels ] [ -d devname ]
               [ -f fmtname | ? ] [ -g gain ] [ -i recsource | ? ] [ -m nfiles ]
               [ -r command ] [ -s rate ] [ -t maxsecs ] filename | - ...

DESCRIPTION

       The  ossrecord program records audio in Microsoft RIFF (wav) format. It will record from any input that's
       currently set as the recording source by the ossxmix/ossmix mixer programs. With the -l option, you  also
       get a level meter that will display VU levels in a character mode.

       The  filename parameter is name of the (.wav) file to be produced. Output can be sent to stdout by giving
       - as the file name.

OPTIONS

       -s<rate>
              Select the recording rate for raw PCM audio (eg -s48000).

       -c<channels>
              Select the number of channels 1=mono 2=stereo, 4, 6, 8, etc.

       -d<devname>
              Select <devname> as the device (eg -d/dev/dsp2).

       -f<fmt>
              Select the input sample format (eg -fS32_LE or -fMU_LAW)

       -f?    Prints the list of supported format names.

       -F<cnt>
              Select the container format (eg WAV or AU). Default is WAV.

       -F?    Prints the list of supported container formats.

       -R     Open audio device in raw mode to disable virtual mixing and sample rate/format conversions. Can be
              used when recording from a digital source (S/PDIF input).

       -v     Verbose output.

       -l     Display level meters (character based).

       -i<recsrc|?>
              Select  the  recording  source  or  display  available recording sources if '?' is supplied.  e.g.
              ossrecord -i? may display: vol line (currently selected) mic cd aux1 phone mono video

       -m<nfiles>
              Repeat the recording operation <nfiles> times. The  filename  argument  must  have  %d  (or  %02d)
              somewhere  in the file to guarantee unique filenames. If no %d is given then subsequent recordings
              will overwrite the previous one(s). This option is useful only with loopback audio devices  or  if
              the -t option is used.

       -r<command>
              This  option launches the <command> in background after recording the file has completed. The name
              of the recorded file will be given as the (only) command line argument. When the -m option is used
              the  script  will  run  in  parallel while recording the next file. See the COMMAND SCRIPT section
              (below) for more info.

       -g<gain>
              Amplify recorded samples by percentage given as  argument.   100  (default)  means  normal  signal
              level, 200 means double level.  Only supported in 16 and 32 bit modes.

       -t<maxsecs>
              Do not record more than <maxsecs> seconds in a single recording operation.

       -L<level>
              Set the recording level to <level>.

       -O     Do not allow ossrecord to overwrite the output file.

       -h     Display usage instructions.

COMMAND SCRIPT

       The -r command line argument makes it possible to execute a script or program after recording of the wave
       file is finished.  Below is a simple scell script that does MP3 encoding using lame.

       #!/bin/sh

              WAVENAME=$1

              MP3NAME=$1.mp3

              lame -m s -h --preset studio $WAVENAME $MP3NAME

              exit 0

              Another example script for ossrecord  is  a  simple  CGI  script  for  live  MP3  streaming  (from
              /dev/dsp).

              #!/bin/sh

              echo Content-Type: audio/mp3

              echo

              ossrecord -S -b16 -s48 - | lame -m j - -

              exit 0

NOTES

       The ossrecord executable is the same as the ossplay executable.  Behaviour is decided by the name used to
       invoke the program.

       Some file formats allocate only 32 bits to record the file length, which may prevent some  programs  from
       reading a too large file properly.  If a recording may pass the 4GB limit (a bit more then 6 hours and 10
       minutes of sound assuming [48Khz/16bit/stereo] quality), it's best to have ossrecord use the  AU  or  RAW
       containers (via -F switch) which do not have this restriction.

SEE ALSO

       ossplay(1), ossmix(1), ossxmix(1)

FILES

       /usr/bin/ossrecord

AUTHOR

       4Front Technologies

                                                  09 July 2018                                      ossrecord(1)