OS Manuals

/usr/bin/speaker-test

ALSA (Advanced Linux Sound Architecture) command-line utilities: aplay, arecord, amixer, alsamixer, alsactl, speaker-test and more

From alsa-utils 1.2.16-r3 (enterprise-packages), captured 2026-11-08 by running speaker-test --help (exit 0). permalink

speaker-test 1.2.16

Usage: speaker-test [OPTION]...
-h,--help	help
-D,--device	playback device
-r,--rate	stream rate in Hz
-c,--channels	count of channels in stream
-f,--frequency	sine wave frequency in Hz
-F,--format	sample format
-b,--buffer	ring buffer size in us
-p,--period	period size in us
-P,--nperiods	number of periods
-t,--test	pink=use pink noise, sine=use sine wave, st2095=use SMPTE ST-2095 noise, wav=WAV file
-l,--nloops	specify number of loops to test, 0 = infinite
-s,--speaker	single speaker test. Values 1=Left, 2=right, etc
-w,--wavfile	Use the given WAV file as a test sound
-W,--wavdir	Specify the directory containing WAV files
-m,--chmap	Specify the channel map to override
-X,--force-frequency	force frequencies outside the 30-8000hz range
-S,--scale	Scale of generated test tones in percent (default=80)

Recognized sample formats are: S8 S16_LE S16_BE FLOAT_LE S24_3LE S24_3BE S24_LE S24_BE S32_LE S32_BE
Options (17)
OptionDescriptionSource
-h, --helpPrint usage helphelp + man
-D, --device NAMEPCM device name NAMEhelp + man
-r, --rate RATEstream rate in Hzhelp + man
-c, --channels NUMcount of channels in streamhelp + man
-f, --frequency FREQsine wave frequency in Hzhelp + man
-F, --formatsample formathelp
-b, --buffer TIMEUse buffer size of TIME microseconds.help + man
-p, --period TIMEUse period size of TIME microseconds.help + man
-P, --nperiods PERIODSUse number of periods.help + man
-t, --test pink|st2095|sine|wavpink=use pink noise, sine=use sine wave, st2095=use SMPTE ST-2095 noise, wav=WAV filehelp + man
-l, --nloops COUNTspecify number of loops to test, 0 = infinitehelp + man
-s, --speaker CHANNELDo a single-shot speaker test for the given channel.help + man
-w, --wavfile FILEUse the given WAV file for the playback instead of pre-defined WAV files.help + man
-W, --wavdir DIRECTORYSpecify the directory containing WAV files for playback.help + man
-m, --chmap MAPSpecify the channel map to overridehelp + man
-X, --force-frequencyAllow supplied FREQ to be outside the default range of 30-8000Hz.help + man
-S, --scaleScale of generated test tones in percent (default=80)help
Examples (6) from the manual page, untested

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.