This is README file for OSS/3D effect plugin for XMMS.
======================================================


WHAT'S THE HOMEPAGE FOR THIS TOOL?
==================================
http://www.xmms.org
http://www.oss3d.com

WHAT IS THIS?
=============
This is an ultimate 3D surround plugin for both XMMS and WinAmp.

WHAT IS THE VERSION NUMBER FOR THIS PRODUCT?
============================================
5.5.1 (with brainwave synthesizer support)

INSTALLATION
============

1. Read LICENSE file

2. Run xminstall.sh

3. Run XMMS

4. If you are using commercial version (as opposite to DEMO), a dialog box
   will appear, where you should enter your registration data.
   
   NOTE: On some older OS distributions, registration dialog will freeze 
         after you enter serial data. In this case, you will have to fix
	 xmms config file manually. If you went to this point, read
	 TROUBLESHOOTING section in the end of this README file.
   
5. Go to Preferences->Effects/General_Plugins and choose "OSS/3D" from 
   dropdown box.

6. Mark "Use plugins" checkbox. 

7. Press "Configure" button to configure OSS/3D
   (If you skip this step, then the surround would be enabled and 
    turned to default settings)

Now you can enjoy with your favorite music. 


SUPPORT
=======

Feel free to obtain support by e-mail: 
support@oss3d.com


TROUBLESHOOTING
===============

On some machines, it happens that commercial version registration dialog 
freezes and disallowes XMMS to run further. To fix this, you need to correct
$HOME/.xmms/config file and add OSS/3D registration section here. To do 
this, open $HOME/.xmms/config in any text editor and seek for section 
[xmoss3d-5] there. If no such section found, go the end of file and make 
new [xmoss3d-5] section. The following lines should be appended to the section:

xmoss3d_ser_name=YOUR NAME
xmoss3d_ser_company=YOUR COMPANY
xmoss3d_ser_zip=YOUR ZIP CODE
xmoss3d_ser_code=SERIAL KEY ISSUED

If this doesn't work for you, or you don't know how to edit config file, feel 
free to request technical support.

