Troubleshooting Guide for Tk3Play - Version 1.00a
http://desmodus.biom.cornell.edu/tk3play/

This Troubleshooting guide is still under construction.
So tk3play doesn't work?

1.  Install the statically linked version of tk3play (the one with 
    static in the name of the distribution file) if you didn't
    originally.  'make cleaninstall' will remove your current 
    installation and install the statically linked version.
    This should insure the problems you're having are not related
    the the version of tcl/tk you have on your system.

2.  Only 96, 112, 128 and 256 kbit/s mpeg streams can be decoded if 
    you're using mpg123.  Make sure the stream you are trying to 
    play is not 56 or 64 kbit/s if you are using mpg123.
    l3dec can decode all bitrate streams.  I've tested it down to 32 kbit/s.

3.  Try running the decoder from the command line using:
    /usr/local/bin/mpg123 -v -s some.mp3 | 
    /usr/local/bin/bwavplay -r -b 16 -s 44100 -S 

    or if you're using l3dec:
    /usr/local/bin/l3dec -sto -ign some.mp3 |
    /usr/local/bin/bwavplay -r -b 16 -s 44100 -S 

4.  If 2 doesn't work try running bwavplay with a 16-bit .wav file:
    /usr/local/bin/bwavplay some16bit.wav


Possible errors:

Error opening audio device:  

   Make sure permissions are set properly
   for /dev/dsp and that the kernel sound support compiled in.

Unable to set sample size:

   Make sure you have a 16-bit sound card and that 16-bit support is 
   compiled into the kernel. (i.e. you've selected the right card)


Well, for now you'll just have to use the error messages to figure out
your problem.  If you still can't figure out what's wrong please send the
results to me and I'll see if I can help.

If everything above works, send me any error messages that tk3play 
might output to stdout/stderr.  Please include the full pathname 
of the mpeg audio file(s) you're having trouble with as well.

Brian Foutz
bef2@cornell.edu

