Modplug Plugin for XMMS v2.0 / libmodplug v0.8.5
 Based on the ModPlug sound engine by Olivier Lapicque <olivierl@jps.net>
 XMMS plugin by Kenton Varda <temporal@gauge3d.org>
 Maintainer is now Konstanty Bialkowski <konstanty@ieee.org>

Olivier Lapicque, author of Modplug, which is arguably the best quality
MOD-playing software available, has placed his sound rendering code in the
public domain.  This library and plugin is based on that code.

For more information on libmodplug, the library for decoding mod-like music
formats, see libmodplug/README.

Contents
--------
 1. Requirements
 2. Features
 3. Options
 4. Troubleshooting

---------------
1. Requirements
---------------
- POSIX OS (Linux or other unix*)
- XMMS 1.0.0 or higher (only for modplug-xmms plugin).

* This library is only guaranteed to work on Linux.  I have received
  conflicting reports on whether or not it will work on Solaris x86.
  One person reported that the plugin compiled fine with the
  "-fpermissive" compiler flag, which I have added.  Others had far
  more trouble.  Note that a recent change to the library should allow
  it to work on PPC and other big-endian systems.

* Under linux there is also modplugplay contributed, which allows command
 line playing of mod files under Linux.

-----------
2. Features
-----------
- Plays 22 different mod formats, including:
    MOD, S3M, XM, IT, 669, AMF (both of them), AMS, DBM, DMF, DSM, FAR,
    MDL, MED, MTM, OKT, PTM, STM, ULT, UMX, MT2, PSM
- Plays zip, rar, gzip, and bzip2 compressed mods.  The following
    extensions are recognized:
    zip:  MDZ,  S3Z,  XMZ,  ITZ
    rar:  MDR,  S3R,  XMR,  ITR
    gzip: MDGZ, S3GZ, XMGZ, ITGZ
   You can also load plain old ZIP, RAR, and GZ files.  If ModPlug finds
   a mod in them, it will play it.
   Note: To play these formats, you need to have the associated
    decompression utilities (unzip, gunzip, unrar) installed.
   Note(2): The format of the mod is NOT determined from the extension on
    compressed mods.  For example, if you zipped a UMX mod and gave it t                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   