
Speex Xmms plugin 0.9.1
=======================

(c) Jens Burkal <jzb@rapanden.dk>
This program is licensed under the GNU GPL, included in the file COPYING.

New versions can be found at: http://jzb.rapanden.dk/projects/speex-xmms


Requirements:
-------------
Xmms development headers (libxmms1-devel)
Ogg development headers (libogg0-devel or libogg1-devel)
Speex (and remember to compile it as shared libraries (./configure --enable-shared))
Gtk+ 1.2 development headers (libgtk+1.2-devel)


Installing:
-----------
 1. tar -zxf speex-xmms-0.9.1.tar.gz
 2. cd speex-xmms
 3. make
 4. su root -c make install


Changelog:
----------
0.9.1
* Fixed bug when seeking
* Increased accuracy when seeking

0.9.0
* Stereo support
* Comment support (read-only)
* Streaming support (http)
* Gtk programming moved to Glade (project file included)


Streaming:
----------
The plugin uses the http-module by the XMMS team.
I don't use a proxy myself, so I haven't tested that code. Please submit bugreports.

Comments:
---------
Speex uses the vorbiscomment standard, which says that comments have to be encoded in utf8.
The plugin supports utf8 for comments, but it is default disabled, since speexenc
doesn't use utf8. To enable utf8-comments, #define USE_UTF8 and compile utf8.c with the
rest of the program.

Broken frames:
--------------
Previous versions would try to recover from broken frames.
Since it was pretty useless, I've removed that functionality.


Known limitations:
------------------
* Seeking in other than the first logical bitstream (chained files) doesn't work.
* Seeking in the last few seconds of the stream, when it's only the buffer playing, doesn't work.
* File info only includes the first bitstream.


Acknowledgments:
----------------
While writing this plugin i have looked at, and been inspired by:
 * speexdec by Jean-Marc Valin
 * decoder_example from vorbis by Xiphophorus
 * vorbis-xmms-plugin by Tony Arcieri
 * wave-xmms-plugin by the XMMS team
 

