mirror of
https://github.com/alsa-project/alsa-utils
synced 2024-11-14 05:55:41 +01:00
148 lines
3.5 KiB
Groff
148 lines
3.5 KiB
Groff
.TH APLAY 1 "2 August 2001"
|
|
.SH NAME
|
|
arecord, aplay \- command-line sound recorder and player for ALSA
|
|
soundcard driver
|
|
.SH SYNOPSIS
|
|
\fBarecord\fP [\fIflags\fP] [filename]
|
|
.SH SYNOPSIS
|
|
\fBaplay\fP [\fIflags\fP] [filename [filename]] ...
|
|
|
|
.SH DESCRIPTION
|
|
\fBarecord\fP is a command-line soundfile recorder for the ALSA soundcard
|
|
driver. It supports several file formats and multiple soundcards with
|
|
multiple devices.
|
|
|
|
\fBaplay\fP is much the same, only it plays instead of recording. For
|
|
supported soundfile formats, the sampling rate, bit depth, and so
|
|
forth can be automatically determined from the soundfile header.
|
|
|
|
.SH INVOKING
|
|
|
|
[\fBarecord\fP | \fBaplay\fP ] [\fIflags\fP] filename
|
|
.TP
|
|
If filename is not specified, the standard output or input is used. The \fBaplay\fP utility accepts multiple filenames.
|
|
|
|
|
|
.SS Options
|
|
.TP
|
|
\fI-h, --help\fP
|
|
Help: show syntax.
|
|
.TP
|
|
\fI--version\fP
|
|
Print current version.
|
|
.TP
|
|
\fI-l, --list-devices\fP
|
|
List all soundcards and digital audio devices
|
|
.TP
|
|
\fI-L, --list-pcms\fP
|
|
List all PCMs defined
|
|
.TP
|
|
\fI-D, --device=NAME\fP
|
|
Select PCM by name
|
|
.TP
|
|
\fI-q --quiet\fP
|
|
Quiet mode. Suppress messages (not sound :))
|
|
.TP
|
|
\fI-t, --file-type TYPE\fP
|
|
File type (voc, wav, raw or au)
|
|
.TP
|
|
\fI-c, --channels=#\fP
|
|
The number of channels
|
|
.TP
|
|
\fI-f --format=FORMAT\fP
|
|
Sample format
|
|
.br
|
|
Recognized sample formats are: S8 U8 S16_LE S16_BE U16_LE U16_BE S24_LE
|
|
S24_BE U24_LE U24_BE S32_LE S32_BE U32_LE U32_BE FLOAT_LE FLOAT_BE
|
|
FLOAT64_LE FLOAT64_BE IEC958_SUBFRAME_LE IEC958_SUBFRAME_BE MU_LAW
|
|
A_LAW IMA_ADPCM MPEG GSM
|
|
.br
|
|
Some of these may not be available on selected hardware
|
|
.br
|
|
There are also two format shortcuts available:
|
|
.nf
|
|
-f cd (16 bit little endian, 44100, stereo [-f S16_LE -c2 -r44100]
|
|
-f dat (16 bit little endian, 48000, stereo) [-f S16_LE -c2 -r48000]
|
|
.fi
|
|
.TP
|
|
\fI-r, --rate=#<Hz>\fP
|
|
Sampling rate in Hertz.
|
|
.TP
|
|
\fI-d, --duration=#\fP
|
|
Interrupt after # seconds
|
|
.TP
|
|
\fI-s, --sleep-min=#\fP
|
|
Min ticks to sleep
|
|
.TP
|
|
\fI-M, --mmap\fP
|
|
Mmap stream
|
|
.TP
|
|
\fI-N, --nonblock\fP
|
|
Nonblocking mode
|
|
.TP
|
|
\fI-F, --period-time=#\fP
|
|
Distance between interrupts is # microseconds
|
|
.TP
|
|
\fI-B, --buffer-time=#\fP
|
|
Buffer duration is # microseconds
|
|
.TP
|
|
\fI--period-size=#\fP
|
|
Distance between interrupts is # frames
|
|
.TP
|
|
\fI--buffer-size=#\fP
|
|
Buffer duration is # frames
|
|
.TP
|
|
\fI-A, --avail-min=#\fP
|
|
Min available space for wakeup is # microseconds
|
|
.TP
|
|
\fI-R, --start-delay=#\fP
|
|
Delay for automatic PCM start is # microseconds
|
|
(relative to buffer size if <= 0)
|
|
.TP
|
|
\fI-T, --stop-delay=#\fP
|
|
Delay for automatic PCM stop is # microseconds from xrun
|
|
.TP
|
|
\fI-v, --verbose\fP
|
|
Show PCM structure and setup.
|
|
This option is accumulative. The VU meter is displayed when this
|
|
is given twice.
|
|
.TP
|
|
\fI-I, --separate-channels\fP
|
|
One file for each channel
|
|
|
|
.SS
|
|
Example:
|
|
|
|
.TP
|
|
\fBaplay -c 1 -t raw -r 22050 -f mu_law foobar\fR
|
|
will play the raw file "foobar" as a
|
|
22050-Hz, mono, 8-bit, Mu-Law .au file.
|
|
|
|
.TP
|
|
\fBarecord -d 10 -f cd -t wav -D copy foobar.wav\fP
|
|
will record foobar.wav as a 10-second, CD-quality wave file, using the
|
|
PCM "copy" (which might be defined in the user's .asoundrc file as:
|
|
.nf
|
|
pcm.copy {
|
|
type plug
|
|
slave {
|
|
pcm hw
|
|
}
|
|
route_policy copy
|
|
}
|
|
.fi
|
|
|
|
.SH SEE ALSO
|
|
\fB
|
|
alsamixer(1),
|
|
amixer(1)
|
|
\fP
|
|
|
|
.SH BUGS
|
|
Note that .aiff files are not currently supported.
|
|
|
|
.SH AUTHOR
|
|
\fBarecord\fP and \fBaplay\fP are by Jaroslav Kysela <perex@suse.cz>
|
|
This document is by Paul Winkler <zarmzarm@erols.com>.
|
|
Updated for Alsa 0.9 by James Tappin <james@xena.uklinux.net>
|
|
|