$Id: INSTALL 749 2007-04-23 23:30:47Z varenet $

If you are upgrading from a previous version, read the UPGRADING file!

This module is pure C and works with Apache 1.3 and Apache 2

The autotools will automatically detect what is available on your system,
but here is the list of the supported audio codecs so far, with the dependencies
to enable them (Debian packages names are given as references) :

 - For audio codecs:
   * Ogg Bitstream Library Development (libogg-dev)
   * Vorbis Library Development (libvorbis-dev)
   * ID3 tag reading library from the MAD project (libid3tag0-dev)
   * MPEG audio decoder development library (libmad0-dev)
   * Free Lossless Audio Codec - C development library (libflac-dev)
   * The MPEG4 library (libmp4v2, no debian package: mpeg4ip.sourceforge.net)
 - For archive support:
   * The libarchive library (libarchive-dev)
  
 AND

 - If you build for Apache 1.3:
   * Apache webserver development kit (apache-dev)
 - If you build for Apache 2:
   * Development headers for apache2 (apache2-dev)
   * The Apache Portable Runtime Library (libapr1-dev)
 
By default, the module will enable support for all codecs and backends, with
respect to the libraries installed on your system. You can change that by using
the following configure flags:
 * --disable-mp3	To disable MP3 support (libmad0-dev, libid3tag0-dev)
 * --disable-vorbis	To disable Ogg Vorbis support (libogg-dev, libvorbis-dev)
 * --disable-flac	To disable FLAC support (libflac-dev)
 * --disable-mp4	To disable MP4 support (libmp4v2)
 * --disable-filecache	To disable flat file cache system

By default, the module will be built for the version of Apache hinted by apxs.
You can set the apxs tool to be used with the following configure option:
 --with-apxs=/path/to/apxs

A few words about performance:
If you are going to use mod_musicindex on a very busy server, there are a few
things that you can tweak to improve performance:
- First, only build the codecs that you /really/ need. This will avoid
  unnecessary lookups on new files.
- Check src/mod_musicindex.h: near the top of this file, you will see a
  "compile time configuration options" section. The most important one here is
  PRETTY_FOLDERS: if set to 0, it will disable the "stream, shuffle, download"
  icons located under the directories names in the listing (but of course not
  those under the main directory name in the header banner), as enabling these
  icons has a major impact on performance. To give you an idea, on a g4@500Mhz,
  browsing a directory containing 350 subdirectories and 0 file with this
  option enabled takes ~30s, and only about 3s when it's disabled. That's a
  10 to 1 ratio! So if you have directories with a great number of
  subdirectories, consider disabling it.

To install, 'make install', then edit your apache config and reload the server.

The Makefile will install the various web-related files (css file, icons) in
/usr/share/mod_musicindex.
You should then add an alias or copy this directory to your document root,
depending on whether you wish to modify them or not.

See the configuration section in the README file.

Enjoy!

Known supported OSes:
	* GNU/Linux
	* FreeBSD (port available)
	* OpenBSD (port available)
	* NetBSD
	* MacOS X
	* Solaris
	
If you have successfully used mod_musicindex with an OS not mentionned here,
please report to musicindex@pateam.org, with "mod_musicindex" in the subject field.
