libAIO XMMS Output Plugin README
Copyright (C) 2003 Hod McWuff <hod@wuff.dhs.org>
- LICENSE
This program is freely redistributable under the terms of the
GNU General Public License version 2 or later. You should have
received a copy of the GPL version 2 along with this program;
see the file named 'COPYING' for details.
If that file is absent, write to:
Free Software Foundation, Inc.
59 Temple Place, Suite 330
Boston, MA 02111-1307 USA
LICENSE EXCEPTIONS:
The files 'COPYING' and 'INSTALL' are provided courtesy of the
Free Software Foundation and carry their own distribution terms.
The files 'autogen.sh' and 'cleanup.sh', while specific to this
package, are generic in nature and may be freely copied without
restriction of any kind.
The files 'configure.ac' and any 'Makefile.am' are more specific
to the build system than to the package itself, and for the sake
of educational value to budding developers, may also be freely
copied without restriction of any kind.
- ACKNOWLEDGMENTS
alsa-xmms and its authors for teaching me how XMMS plugins work
gaarde@yahoo.com for config UI design advice and alpha testing
the GNOME team for the config dialog's title icon
FINDING AIO-XMMS:
The latest release can be downloaded from:
http://sourceforge.net/projects/aio-xmms
The dependency, libaio, can be downloaded from:
http://sourceforge.net/projects/libaio
At the time of this release, the CVS version of libaio is
required. libaio-0.2.0 or later should work once it gets
released.
BUILDING FROM CVS:
Just run './autogen.sh' from the package directory and watch
the fireworks. When that script completes successfully, the
package directory will be ready for installation just like a
release tarball; see file INSTALL for details.
You will need automake-1.7 and a recent autoconf in order to
build from CVS. If you don't know, you probably shouldn't be
messing around with CVS versions of anything anyway.
BUILDING A RELEASE:
Verbose information is contained in INSTALL; on most systems
it will go something like this:
cd ~/src && tar xjvf ~/downloads/aio-xmms-<version>.tar.bz2
cd aio-xmms-<version>
./configure --prefix=/usr
make
su root make install
At this time there are no package specific configure options.
PLUGIN DEVELOPMENT STATUS:
What works:
playing
seeking
external configuration interface (gtk+-2.x)
What doesn't:
help button
mixer control
effect plugins
runtime status viewing
XMMS plugin config button
automatic period size setup
* detect size of first write
enforced period size compensation
* SHL period size until > arbitrary minimum
* some way to detect minimum likely scheduling interval?
CONTACTING THE AUTHOR:
Please email Hod McWuff <hod@wuff.dhs.org> for all issues
related to the plugin. If you need help with XMMS itself,
go to http://www.xmms.org