speaker-test

SPEAKER-TEST(1)                                                SPEAKER-TEST(1)



NAME
       speaker-test - command-line speaker test tone generator for ALSA

SYNOPSIS
       speaker-test [-options]


DESCRIPTION
       speaker-test  generates a tone that can be used to test the speakers of
       a computer.


OPTIONS
       -c | --channels NUM
              NUM channels in stream


       -D | --device NAME
              PCM device name NAME


       -f | --frequency FREQ
              sine wave of FREQ Hz


       --help Print usage help


       -b | --buffer TIME
              Use buffer size of TIME microseconds.  When 0 is given, use  the
              maximal buffer size.  The default value is 0.


       -p | --period TIME
              Use  period  size  of  TIME  microseconds.  When 0 is given, the
              periods given by -P option is used.  The default value is 0.


       -P | --nperiods PERIODS
              Use number of periods.  The default value is 4.


       -r | --rate RATE
              stream of RATE Hz


       -t | --test pink|sine|wav
              -t pink 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.

              -t sine means to use sine wave.

              -t wav 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.


       -l | --nloops COUNT

              Specifies the number of loops.  Zero means to run infinitely.

              When -s option below with a valid channel is given, speaker-test
              will perform always a single-shot without looping.


       -s | --speaker CHANNEL
              Do a single-shot speaker test for the given channel.  The  chan‐
              nel  number  starts  from  1.  The channel number corresponds to
              left, right,  rear-left,  rear-right,  center,  LFE,  side-left,
              side-right, and so on.

              For  example,  when  1 is passed, it tests the left channel only
              once rather than both channels with looping.


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


       -W | --wavdir
              Specify  the  directory  containing WAV files for playback.  The
              default path is /usr/share/sounds/alsa.



USAGE EXAMPLES
       Produce stereo sound from one stereo jack:
         speaker-test -Dplug:front -c2

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

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

       To send a nice low 75Hz tone to the Woofer and then exit without touch‐
       ing any other speakers:
         speaker-test -Dplug:surround51 -c6 -s1 -f75


AUTHOR
       The  speaker-test  program  was written by James Courtier-Dutton.  Pink
       noise support was added by Nathan Hurst.  Further extensions by Takashi
       Iwai.



speaker-test                   20 September 2004               SPEAKER-TEST(1)