man/man1/ossrecord.1

   1 ." Automatically generated text
   2 .TH 1 "August 31, 2006" "OSS" "User Commands"
   3 .SH NAME
   4 ossrecord - Open Sound System recording program.
   5
   6 .SH USAGE
   7 ossrecord [options] filename
   8
   9 .SH DESCRIPTION
  10 The ossrecord program records audio in Microsoft RIFF (wav) format. It
  11 will record from any input that's currently set as the recording source
  12 by the ossxmix/ossmix mixer programs. With the -l option, you also get
  13 a level meter that will display VU levels in a character mode.
  14
  15 The filename parameter is name of the (.wav) file to be produced. Output can be
  16 sent to stdout by giving - as the file name.
  17
  18 .SH OPTIONS
  19 -s<rate>        Select the recording rate for raw PCM audio (eg -s48000).
  20 -c<channels>    Select the number of channels 1=mono 2=stereo, 4, 6, 8, etc.
  21 -d<devname>     Select <devname> as the device (eg -d/dev/dsp2).
  22 -f<fmt>         Select the output sample format (eg -fS32_LE or -fMU_LAW)
  23 -f?             Prints the list of supported format names.
  24 -F<cnt>         Select the container format (eg WAV or AU). Default is WAV.
  25 -F?             Prints the list of supported container formats.
  26 -R              Open audio device in raw mode to disable virtual mixing and
  27                 sample rate/format conversions. Can be used when recording
  28                 from a digital source (S/PDIF input).
  29 -v              Verbose output.
  30 -l              Display level meters (character based).
  31 -i<recsrc|?>    Select the recording source or display available recording
  32                 sources if '?' is supplied.
  33                 e.g. ossrecord -i? may display:
  34                                 vol
  35                         line (currently selected)
  36                         mic
  37                         cd
  38                         aux1
  39                         phone
  40                         mono
  41                         video
  42 -m<nfiles>      Repeat the recording operation <nfiles> times. The filename
  43                 argument must have %d (or %02d) somewhere in the file to
  44                 guarantee unique filenames. If no %d is given then subsequent
  45                 recordings will overwrite the previous one(s). This option is
  46                 useful only with loopback audio devices or if the -t option
  47                 is used.
  48 -r<command>     This option launches the <command> in background after
  49                 recording the file has completed. The name of the recorded file
  50                 will be given as the (only) command line argument. When the -m
  51                 option is used the script will run in parallel while recording
  52                 the next file. See the COMMAND SCRIPT section (below) for more
  53                 info.
  54 -g<gain>        Amplify recorded samples by percentage given as argument.
  55                 100 (default) means normal signal level, 200 means double level.
  56                 Only supported in 16 and 32 bit modes.
  57 -t<maxsecs>     Do not record more than <maxsecs> seconds in a single recording
  58                 operation.
  59 -L<level>       Set the recording level to <level>.
  60 -O              Allow overwriting of file when recording.
  61 -h              Display usage instructions.
  62
  63 .SH COMMAND SCRIPT
  64                 The -r command line argument makes it possible to execute a
  65                 script or program after recording of the wave file is finished.
  66                 Below is a simple scell script that does MP3 encoding using
  67                 lame.
  68
  69 #!/bin/sh
  70
  71 WAVENAME=$1
  72
  73 MP3NAME=$1.mp3
  74
  75 lame -m s -h --preset studio $WAVENAME $MP3NAME
  76
  77 exit 0
  78
  79 Another example script for ossrecord is a simple CGI script for live MP3
  80 streaming (from /dev/dsp).
  81
  82 #!/bin/sh
  83
  84 echo Content-Type: audio/mp3
  85
  86 echo
  87
  88 ossrecord -S -b16 -s48 - | lame -m j - -
  89
  90 exit 0
  91
  92 .SH NOTES
  93 The ossrecord executable is the same as the ossplay executable.
  94 Behaviour is decided by the name used to invoke the program.
  95
  96 .SH SEE ALSO
  97 ossplay(1), ossmix(1), ossxmix(1)
  98
  99 .SH FILES
 100 /usr/bin/ossrecord
 101
 102 .SH AUTHOR
 103 4Front Technologies