audioplay(1)
- NetBSD Manual Pages
AUDIOPLAY(1) NetBSD General Commands Manual AUDIOPLAY(1)
NAME
audioplay -- play audio files
SYNOPSIS
audioplay [-iqVh] [-v volume] [-b balance] [-p port] [-d device] [-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
assumed 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:
-i If the audio device cannot be opened, exit now rather than wait
for it.
-q Be quiet.
-V Be verbose.
-h Print a help message.
-v Set the volume (gain) to volume. This value must be between 0
and 255.
-b Set the balance to balance. This value must be between 0 and 63.
-p Set the output port to port. The valid values of port are
``speaker'', ``headphone'' and ``line''.
-d Set the audio device to be device. The default is /dev/sound.
-f Force playing, even if the format is unknown. The -f flag can be
used in addition with the following flags to change the number of
channels, encoding, precision and sample rate.
-c when combined with the -f option, sets the number of channels to
its argument.
-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.
-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.
-s when combined with the -f option, sets the sample rate to its
argument. This value must be a valid value for the audio device
or an error will be returned.
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
encodings:
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>.
NetBSD 3.1 January 13, 2002 NetBSD 3.1
Powered by man-cgi (2024-03-20).
Maintained for NetBSD
by Kimmo Suominen.
Based on man-cgi by Panagiotis Christias.