diff --git a/alsamixer/alsamixer.1 b/alsamixer/alsamixer.1 new file mode 100644 index 0000000..6c4f9aa --- /dev/null +++ b/alsamixer/alsamixer.1 @@ -0,0 +1,119 @@ +.TH ALSAMIXER 1 "25 Nov 1998" +.SH NAME +alsamixer \- soundcard mixer for ALSA soundcard driver, with ncurses interface +.SH SYNOPSIS + +\fBalsamixer\fP [\fIoptions\fP] + +.SH DESCRIPTION +\fBalsamixer\fP is an ncurses mixer program for use with the ALSA +soundcard drivers. It supports multiple soundcards with multiple devices. + +.SH INVOKING + +\fBalsamixer\fP [\fIoptions\fP] + +.SS Options + +.TP +\fI-h, -help\fP +Help: show available flags. + +.TP +\fI-c\fP +Select the soundcard to use, if you have more than one. Cards are +numbered from 1 (the default). + +.TP +\fI-m\fP +Select the soundcard device to control, if your card has more than +one. Devices are numbered from 0 (the default). Not to be confused +with the soundcard mixer channels, which are sometimes also referred +to as "devices", just to be annoying. Many soundcards will only have +device 0. Some more complex cards may have more. This flag corresponds +to the -d flag for \fBamixer\fP, \fBarecord\fP, and \fBaplay\fP. + +.TP +\fI-e\fP +Start in "exact mode." This will affect the numbers you see displayed +for volumes, but does not affect operation of the level controls. +The default behavior is to show levels in percent from 0 to 100. This +is easy to read, but can mislead you about how much control the +soundcard actually lets you have. Exact mode, on the other hand, shows +you the settings as the soundcard itself understands them. In exact +mode, each channel level is between 0 and a power of 2 minus one +(e.g. 0-7, or 0-63). Exact mode may also be toggled while alsamixer is +running, by using \fITAB\fP. + +.SH KEYBOARD COMMANDS +\fBalsamixer\fP recognizes the following keyboard commands to control the soundcard. + +.SS +General Controls + +The \fILeft\fP and \fIright arrow\fP keys are used to select the +channel (or device, depending on your preferred terminology). You can +also use \fIn\fP ("next") and \fIp\fP ("previous"). + +The \fIUp\fP and \fIDown Arrows\fP control the volume for the +currently selected device. You can also use \fI+\fP or \fI-\fP for the +same purpose. Both the left and right signals are affected. For +independent left and right control, see below. + +\fIM\fP toggles muting for the current channel (both left and right). You can +mute left and right independently by using \fI,\fP and \fI.\fP respectively. + +\fISPACE\fP toggles recording: the current channel will be added or +removed from the sources used for recording. This only works for valid +input channels, of course. + +\fIL\fP re-draws the screen. + +\fITAB\fP toggles the mode for volume display. See description for the +\fI-e\fP flag above. + +.SS +Quick Volume Changes + +\fIPageUp\fP increases volume by 10. + +\fIPageDown\fP decreases volume by 10. + +\fIHome\fP sets volume to maximum. + +\fIEnd\fP sets volume to 0. + +You can also control left & right levels for the current channel +independently, as follows: + +[\fIQ\fP | \fIW\fP | \fIE\fP ] -- turn UP [ left | both | right ] + +[\fIZ\fP | \fIX\fP | \fIC\fP ] -- turn DOWN [ left | both | right ] + +If the currently selected mixer channel is not a stereo channel, then +all UP keys will work like \fIW\fP, and all DOWN keys will work like \fIX\fP. + +.SS +Exiting + +Quit the program with \fIALT Q\fP, or by hitting \fIESC\fP. + +.SH SEE ALSO +\fB +amixer(1), +arecord(1) +\fP + +.SH BUGS +None known. Some terminal emulators (e.g. \fBnxterm\fP) may not +work quite right with ncurses, but that's their own damn +fault. Plain old \fBxterm\fP seems to be fine. + +.SH AUTHOR +\fBalsamixer\fP is by Jaroslav Kysela +This document is by Paul Winkler . + + + + + diff --git a/aplay/arecord.1 b/aplay/arecord.1 new file mode 100644 index 0000000..043a830 --- /dev/null +++ b/aplay/arecord.1 @@ -0,0 +1,112 @@ +.TH APLAY 1 "25 Nov 1998" +.SH NAME +arecord, aplay \- command-line sound recorder and player for ALSA soundcard driver +.SH SYNOPSIS + +[\fBarecord\fP | \fBaplay\fP ] [\fIflags\fP] 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 + +.SS Options +.TP +\fI-h, --help\fP +Help: show syntax. +.TP +\fI-V, --version\fP +Print current version. +.TP +\fI-l\fP +List all available soundcards and devices. +.TP +\fI-c\fP +Select the soundcard to use, if you have more than one. Cards are +numbered from 1 (the default). +.TP +\fI-d\fP +Select the soundcard device to use, if your card has more than +one. Devices are numbered from 0 (the default). Not to be confused +with the soundcard mixer channels, which are sometimes also referred +to as "devices", just to be annoying. Many soundcards will only have +device 0. Some more complex cards may have mor. Try using \fI-l\fP +and see what you get. + +.TP +\fI-q\fP +Quiet mode. Suppress messages (not sound :)) + +.TP +\fI-w\fP +Use Wave soundfile format (.wav) +.TP +\fI-r\fP +Use raw soundfile format. Requires -s, -b, and -p flags? +.TP +\fI-u\fP +Use Sparc Audio soundfile format (.au) +.TP +\fI-v\fP +Use Voc soundfile format +.TP +\fI-S\fP +Soundfile is stereo. Mono is the default for headerless files. +.TP +\fI-t \fP +Time limit for recording, in seconds. +.TP +\fI-s \fP +Sampling rate in Hertz. +.TP +\fI-b \fP +Bit depth (8 or 16 bits). +.TP +\fI-m\fP +Set to CD standard quality (44100 Hz, stereo, 16-bit linear). +.TP +\fI-M \fP +Set to DAT quality (48000 Hz, stereo, 16-bit linear). +.TP +\fI-p \fP +Compression type (alaw, ulaw, adpcm). + +.SS +Example: + +.RS +\fBaplay -c 2 -r -u -s 22050 -b 8 -p ulaw foobar\fR + +.ID +will play the raw file "foobar" as a +22050-Hz, mono, 8-bit, Mu-Law .au file, using the second soundcard. + +\fBarecord -t 10 -m -w foobar.wav\fP + +will record foobar.wav as a 10-second, CD-quality wave file. + +.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 +This document is by Paul Winkler . + + + + +