AUDIOPLAY(1) | General Commands Manual | AUDIOPLAY(1) |
audioplay
— play
audio files
audioplay |
[-hinqV ] [-B
buffersize] [-b
balance] [-d
device] [-p
port] [-v
volume] [-f
[-c channels]
[-e encoding]
[-P precision]
[-s sample-rate]] [files
...] |
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.
The following options are available:
-B
-b
-c
-f
option, sets the number
of channels to its argument.-d
-e
-f
option, sets the
encoding to its argument. 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
-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
-i
-n
-P
-f
option, sets the
precision to its argument. This value must be either 4, 8, 16, 24 or
32.-p
-q
-s
-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.-V
-v
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
audioplay
can be used to play Sun/NeXT
audio files, and also RIFF WAVE audio files.
audioplay
can be configured in a web browser as the
program to use when playing audio files.
In addition to the audio driver encodings list in the EXAMPLES
section, audioplay
supports playing IEEE floating
point data in RIFF WAVE audio files (with one caveat that the floating point
size must be native). In this case audioplay
converts the floating point data into signed linear samples before they are
passed to the chosen audio device.
If the audio device or the control device can not be opened, an 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.
The audioplay
program was first seen in
SunOS 5. The NetBSD
audioplay
was first made available in
NetBSD 1.4. Support for RIFF WAVE recording was
introduced in NetBSD 1.6. Support for RIFF WAVE IEEE
floating point data was introduced in NetBSD
10.0.
The audioplay
program was written by
Matthew R. Green
<mrg@eterna23.net>.
March 3, 2024 | NetBSD 10.99 |