aplay(1) aplay(1)
NAME
aplay - An AF play client.
SYNOPSIS
aplay [-server audioserver] [-d device] [-t time] [-g gain] [-e encoding]
[-f ] [-c] [-b] [-l] [file]
DESCRIPTION
aplay reads samples from file, or stdin if file is not specified, and sends
the sound data to the audio server for playback. The file is assumed to be
of a sample format appropriate for the playback device.
OPTIONS
-server audioserver
Specifies which audio server to connect to in order to play the sound
file. If audioserver is not specified, aplay uses the default server.
See the AUDIOFILE environment variable.
-d device
Specifies which audio device to play the sound file through. If dev-
ice is not specified, aplay defaults to the first device that isn't
connected to the telephone.
-t time
time can be used to adjust the audio device time at which the the
aplay client begins to play the sound data. A positive value of time
will begin playing time seconds in the future. If time is negative,
time seconds of sound data will be "thrown away". The default is 0.1
seconds.
-e ncoding
encoding will specify the type of the data being read from the file or
standard input. Legal values are described in the audio.h header
file, and may be obtained via aplay -e xxx. The -e flag simply
informs the AF server of the datatype.Some encodings may fail if they
are not supported by the AF server. See also aconvert(1).
-g gain
A gain in dB can be used to attenuate or amplify the sound data prior
to mixing in the audio server.
-f
The -f switch turns on flush mode, which forces aplay to wait until
the last sound has been played before exiting.
-c
The -c switch instructs aplay to play to the canonical sound bytes
shipped with the AF kit. This switch depends on the SOUND_PATH
environment variable.
-b
Specifies that for 16 bit data, the bytes are in "Big Endian" byte
order (e.g. Sparc, RIOS, PA).
-l
Specifies that for 16 bit data, the bytes are in "Little Endian" byte
order (e.g. Alpha, Intel x86, VAX).
file
aplay attempts to read from file in the current working directory or
from one of the directories in the SOUND_PATH environment variable if
it is set.
ENVIRONMENT
AUDIOFILE specifies the host and server to use.
SOUND_PATH specifies a colon-separated list of directories in which
sounds may be found.
BUGS
There is no way to play back a file in preempt mode.
If you encounter a reproducible bug, please submit a problem report to
(af-bugs@crl.dec.com).
SEE ALSO
AF(1), arecord(1)
COPYRIGHT
Copyright 1992-1994, Digital Equipment Corporation.
See AF(1) for a full statement of rights and permissions.
AUTHORS
Digital Cambridge Research Lab