MIXCGI V1.0 release notes
=========================

What is this?
=============

MIXCGI is a CGI interface to the linux /dev/mixer subsystem. That is, it
allows a computer's soundboard mixer to be controlled remotely using a Web
browser. This is handy if a number of computer users share a CD player or MP3
player and need to control it remotely.


Installation
============

Copy the CGI program mixcgi.cgi' to your Web server's CGI directory.
With a standard Linux distribution with Apache, this will probably be
/home/httpd/cgi-bin. You may need to enable CGI support on your server.

Create or modify a Web page to link to the mixer. For example, add the
following link to any page:

<a href=/cgi-bin/mixcgi.cgi>Audio mixer</a> 


Use
===

In operation, MIXCGI displays a set of sliders, one for each property
controllable by the soundboard. If the soundboard says that these are
stereo properties, then a `balance' slider and a `volume' slider are
displayed; otherwise you will only get a `volume' slider. Below the slider
section is a form where you can set the values numerically, on a scale of
0-100.


Compilation
===========

The binaries supplied in this package are for Intel (i386) Linux. If you have
anything else you will need to recompile. I doubt that this software will work
on anything other than Linux, as it uses ioctl() calls on /dev/mixer. However,
it should work with non-Intel Linux variations.


Troubleshooting
===============

If you get the message `can't open /dev/mixer', check that this device really
exists, and that the account that owns the Web server can read and write it.
Typically: `chmod ugo+rw /dev/mixer'. Check the mixer using a stand-alone
program, e.g., `aumix' first, to verify that the drivers are loaded and the
hardware functions correctly. Check the Web server error log.


Author and copyright
====================

MIXCGI was written by Kevin Boone. It is (c)2001 Kevin Boone, all rights
reserved. Please see the file COPYING.txt for licensing information.


Disclaimer
==========

This software is distributed free of charge in the hope that it will be
useful. There is absolutely no warranty.