1SPEAKER-TEST(1)             General Commands Manual            SPEAKER-TEST(1)
2
3
4

NAME

6       speaker-test - command-line speaker test tone generator for ALSA
7

SYNOPSIS

9       speaker-test [-options]
10
11

DESCRIPTION

13       speaker-test  generates a tone that can be used to test the speakers of
14       a computer.
15
16

OPTIONS

18       -c | --channels NUM
19              NUM channels in stream
20
21
22       -D | --device NAME
23              PCM device name NAME
24
25
26       -f | --frequency FREQ
27              sine wave of FREQ Hz
28
29
30       --help Print usage help
31
32
33       -b | --buffer TIME
34              Use buffer size of TIME microseconds.  When 0 is given, use  the
35              maximal buffer size.  The default value is 0.
36
37
38       -p | --period TIME
39              Use  period  size  of  TIME  microseconds.  When 0 is given, the
40              periods given by -P option is used.  The default value is 0.
41
42
43       -P | --nperiods ERIODS
44              Use number of periods.  The default value is 4.
45
46
47       -r | --rate RATE
48              stream of RATE Hz
49
50
51       -t | --test pink|sine|wav
52              -t pink means use pink noise (default).
53
54              Pink noise is perceptually uniform noise -- that is,  it  sounds
55              like  every  frequency at once.  If you can hear any tone it may
56              indicate resonances in your speaker system or room.
57
58              -t sine means to use sine wave.
59
60              -t wav means to play WAV  files,  either  pre-defined  files  or
61              given via -w option.
62
63              You can pass the number from 1 to 3 as a backward compatibility.
64
65
66       -l | --nloops COUNT
67
68              Specifies the number of loops.  Zero means to run infinitely.
69
70              When -s option below with a valid channel is given, speaker-test
71              will perform always a single-shot without looping.
72
73
74       -s | --speaker CHANNEL
75              Do a single-shot speaker test for the given channel.  The  chan‐
76              nel  number  starts  from  1.  The channel number corresponds to
77              left, right,  rear-left,  rear-right,  center,  LFE,  side-left,
78              side-right, and so on.
79
80              For  example,  when  1 is passed, it tests the left channel only
81              once rather than both channels with looping.
82
83
84       -w | --wavfile
85              Use the given WAV file for the playback instead  of  pre-defined
86              WAV files.
87
88
89       -W | --wavdir
90              Specify  the  directory  containing WAV files for playback.  The
91              default path is /usr/share/sounds/alsa.
92
93
94

USAGE EXAMPLES

96       Produce stereo sound from one stereo jack:
97         speaker-test -Dplug:front -c2
98
99       Produce 4 speaker sound from two stereo jacks:
100         speaker-test -Dplug:surround40 -c4
101
102       Produce 5.1 speaker sound from three stereo jacks:
103         speaker-test -Dplug:surround51 -c6
104
105       To send a nice low 75Hz tone to the Woofer and then exit without touch‐
106       ing any other speakers:
107         speaker-test -Dplug:surround51 -c6 -s1 -f75
108
109

AUTHOR

111       The  speaker-test  program  was written by James Courtier-Dutton.  Pink
112       noise support was added by Nathan Hurst.  Further extensions by Takashi
113       Iwai.
114
115
116
117speaker-test                   20 September 2004               SPEAKER-TEST(1)
Impressum