Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
AUDIOPLAY(1)		  BSD General Commands Manual		  AUDIOPLAY(1)

NAME
     audioplay -- play audio files

SYNOPSIS
     audioplay [-hiqV] [-B buffersize] [-b balance] [-d	device]	[-p port]
	       [-v volume] [-f [-c channels] [-e encoding] [-P precision]
	       [-s sample-rate]] [files	...]

DESCRIPTION
     The audioplay program copies the named audio files, or the	standard input
     if	no files are named, to the audio device.  The special name "-" is as-
     sumed to mean the standard	input.	The input files	must contain a valid
     audio header, and the encoding must be understood by the underlying
     driver.

OPTIONS
     The following options are available:

     -B	     Set the write block size to buffersize.  The default value	is the
	     play.buffer_size of the audio device.

     -b	     Set the balance to	balance.  This value must be between 0 and 63.

     -c	     When combined with	the -f option, sets the	number of channels to
	     its argument.

     -d	     Set the audio device to be	device.	 The default is	/dev/sound.

     -e	     When combined with	the -f option, sets the	encoding to its	argu-
	     ment.  Possible values are	mulaw, ulaw, alaw, slinear, linear,
	     ulinear, adpcm, ADPCM, slinear_le,	linear_le, ulinear_le,
	     slinear_be, linear_be, ulinear_be,	mpeg_l1_stream,
	     mpeg_l1_packets, mpeg_l1_system, mpeg_l2_stream, mpeg_l2_packets,
	     and mpeg_l2_system.

     -f	     Force playing, even if the	format is unknown.  The	-f flag	can be
	     used in addition with the -c, -e, -P, and -s flags	to change the
	     number of channels, encoding, precision, and sample rate.

     -h	     Print a help message.

     -i	     If	the audio device cannot	be opened, exit	now rather than	wait
	     for it.

     -P	     When combined with	the -f option, sets the	precision to its argu-
	     ment.  This value must be either 4, 8, 16,	24 or 32.

     -p	     Set the output port to port.  The valid values of port are
	     "speaker",	"headphone" and	"line".

     -q	     Be	quiet.

     -s	     When combined with	the -f option, sets the	sample rate to its ar-
	     gument.  This value must be a valid value for the audio device or
	     an	error will be returned.

     -V	     Be	verbose.

     -v	     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
     Play a raw	dump taken from	an audio CD ROM:

	   audioplay -f	-c 2 -P	16 -s 44100 -e slinear_le filename

     The audioctl(1) program can be used to show the available supported en-
     codings:

	   audioctl encodings

NOTES
     audioplay can be used to play Sun/NeXT audio files, and also RIFF WAVE
     audio files.  audioplay can be configured in the "Netscape" web browser
     as	the program to use when	playing	audio files.

ERRORS
     If	the audio device or the	control	device can not be opened, and error is
     returned.

     If	an invalid parameter is	specified, an error is returned.  The set of
     valid values for any audio	parameter is specified by the hardware driver.

SEE ALSO
     audioctl(1), audiorecord(1), aria(4), audio(4), audioamd(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), sv(4),
     wss(4), yds(4), ym(4)

HISTORY
     The audioplay program was first seen in SunOS 5.  The NetBSD audioplay
     was first made available in NetBSD	1.4.

AUTHORS
     The audioplay program was written by Matthew R. Green
     <mrg@eterna.com.au>.

BSD			       December	30, 2010			   BSD

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT | EXAMPLES | NOTES | ERRORS | SEE ALSO | HISTORY | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=audioplay&sektion=1&manpath=NetBSD+6.0>

home | help