.\" -*- nroff -*-
.\" macros
.de EX \" Begin Example
.  IP
.  ft CW
.  nf
.  ne \\$1
..
.de EE \" End Example
.  ft P
.  fi
.  PP
..
.TH SPEAKER\-TEST 1 "20 September 2004" speaker-test
.SH NAME
speaker\-test \- command-line speaker test tone generator for ALSA 
.SH SYNOPSIS
.B speaker\-test
.BR "" [ \-D | \-\-device 
.IR NAME ]
.BR "" [ \-r | \-\-rate
.IR RATE ]
.BR "" [ \-c | \-\-channels
.IR NUM ]
.BR "" [ \-f | \-\-frequency
.IR FREQ ]
.BR "" [ \-p | \-\-period
.IR TIME ]
.BR "" [ \-n | \-\-noise
.IR TIME ]
.BR "" [ \-s | \-\-speaker
.IR TYPE ]
.BR "" [ \-w | \-\-wavfile
.IR FILE ]
.BR "" [ \-W | \-\-wavdir
.IR DIR ]
.P
.B speaker\-test
.B \-\-help

.SH DESCRIPTION
\fBspeaker\-test\fP generates a tone that can be used to test the speakers of a computer.

.SH OPTIONS

.TP
\fB\-c\fP | \fB\-\-channels\fP \fINUM\fP
\fINUM\fP channels in stream

.TP
\fB\-D\fP | \fB\-\-device\fP \fINAME\fP
PCM device name \fINAME\fP

.TP
\fB\-f\fP | \fB\-\-frequency\fP \fIFREQ\fP
sine wave of \fIFREQ\fP Hz

.TP
\fB\-\-help\fP
Print usage help

.TP
\fB\-p\fP | \fB\-\-period\fP \fITIME\fP
period size of \fITIME\fP microseconds

.TP
\fB\-r\fP | \fB\-\-rate\fP \fIRATE\fP
stream of \fIRATE\fP Hz

.TP
\fB\-s\fP | \fB\-\-speaker\fP \fBpink\fP|\fBsine\fP|\fBwav\fP
-tpink means use pink noise (default).

Pink noise is perceptually uniform noise - that is, it sounds like every frequency at once.  If you can hear any tone it may indicate resonances in your speaker system or room.

-tsine means use sine wave.

-twav means to play WAV files, either pre-defined files or given via -w option.

You can pass the number from 1 to 3 as a backward compatibility.

.TP
\fB\-s\fP | \fB\-\-speaker\fP \fBpink\fP|\fBsine\fP|\fBwav\fP
Test speaker 1 or speaker 2 only, rather than both

.TP
\fB\-w\fP | \fB\-\-wavfile\fP
Use the given WAV file for the playback instead of pre-defined WAV files.

.TP
\fB\-W\fP | \fB\-\-wavdir\fP
Specify the directory containing WAV files for playback.


.SH USAGE EXAMPLES

Produce stereo sound from one stereo jack:
.EX
  speaker-test -Dplug:front -c2
.EE

Produce 4 speaker sound from two stereo jacks:
.EX
  speaker-test -Dplug:surround40 -c4
.EE

Produce 5.1 speaker sound from three stereo jacks:
.EX
  speaker-test -Dplug:surround51 -c6
.EE

To send a nice low 75Hz tone to the Woofer and then exit without touching any other speakers:
.EX
  speaker-test -Dplug:surround51 -c6 -s1 -f75
.EE

.SH AUTHOR
The speaker-test program was written by James Courtier-Dutton.
Pink noise support was added by Nathan Hurst.