minix/man/man1/ossrecord.1
2009-10-01 16:36:14 +00:00

103 lines
3.3 KiB
Groff

." Automatically generated text
.TH 1 "August 31, 2006" "OSS" "User Commands"
.SH NAME
ossrecord - Open Sound System recording program.
.SH USAGE
ossrecord [options] filename
.SH 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.
.SH 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 output 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 Allow overwriting of file when recording.
-h Display usage instructions.
.SH 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
.SH NOTES
The ossrecord executable is the same as the ossplay executable.
Behaviour is decided by the name used to invoke the program.
.SH SEE ALSO
ossplay(1), ossmix(1), ossxmix(1)
.SH FILES
/usr/bin/ossrecord
.SH AUTHOR
4Front Technologies