BPLAY(1)						      General Commands Manual							  BPLAY(1)

NAME

       bplay, brec - buffered sound recording/playing

SYNOPSIS

       bplay [-d device] [-B buffersize] [-S] [-s speed] [-b bits] [[-t secs] | [-T samples]] [[-j secs] | [-J samples]] [-D level] [file]

       brec [-d device] [-B buffersize] [-S] [-s speed] [-b bits] [[-t secs] | [-T samples]] [-r|-v|-w] [-D level] [file]

DESCRIPTION

       bplay copies data from the named sound file (or the standard input if no filename is given) to the audio device.

       brec copies data from the audio device to the named sound file (or the standard output if no filename is present).

       These programs are intended to be drop-in replacements for the vplay and vrec programs by Michael Beck (beck@informatik.hu-berlin.de).

   OPTIONS
       -B buffersize
	      Use the supplied audio buffer size instead of the default.

       -d device
	      Use the supplied audio device instead of the default.

       -S     Sound file is stereo.

       -s speed
	      The speed in samples per second.

       -b bits
	      The number of bits per sample. Only 8 and 16 are currently supported.

       -t secs
	      The number of seconds to be played or recorded.

       -T samples
	      The number of samples to be played or recorded.

       -j secs
	      When playing, the number of seconds to skip at the beginning of the input before playing.

       -J samples
	      When playing, the number of samples to skip at the beginning of the input before playing.

       -r     When recording, write raw sound file.

       -v     When recording, write Creative Labs VOC sound file.

       -w     When  recording  write Microsoft Wave sound file. Note that the WAVE file format is limited to 4GiB filesize. Recording more data is
	      possible, but the length info won't be consistent.

       -q     Quiet mode.  No messages are displayed.

       -D level
	      Print debug information to stderr. Debug level ranges from 0 to 2, where 0 is no debug information.

FILES

       /dev/dsp The audio device.

BUGS

       The -t, -T, -j and -J options may do strange things when playing VOC files.

       There are limitations on recording VOC format files - specifically VOC files are only recorded in the 1.20 version  of  the  format,  which
       some  player programs may choke on. There is also currently a limit of around 16M on the size of a VOC file which will be recorded. This is
       probably not a problem since I don't think anybody really uses VOC files anymore.

       This program prefers to run setuid root. This is because it wants to use setpriority() to run at the highest possible  priority,  and  also
       locks down the buffers it uses to avoid them being swapped out.

AUTHOR

       David Monro (davidm@amberdata.demon.co.uk or davidm@cs.usyd.edu.au)

       The option parsing code was originally taken from vplay to maintain compatibility.

								 20 September 1999							  BPLAY(1)