			** MOUL Sound Decompressor Tool **
			Release Version 1.11 (2010-03-08)
	
		Written by Joseph Davies (deledrius@gmail.com)



These scripts are aimed at MOUL players on Linux and OSX, where the automatic 
decompression for the streamingCache files fails, leaving the player 
with no sound, or worse.


This python script requires:

	-- libHSPlasma and PyHSPlasma: http://code.google.com/p/libhsplasma/
	   
	-- SoX: http://sox.sourceforge.net/
	
Additionally, the GUI tool requires:

	-- wxPython: http://wxpython.org/



Installation -
	The script should work with Python 2.6 and Python 3.x
	
	For information on building libPlasma, see the Guild of Writers forum:
		http://forum.guildofwriters.com/viewtopic.php?f=86&t=2639
	
	Ubuntu:
		sudo apt-get update && sudo apt-get install sox python-wxgtk2.8
		
	OS X:
		Install Python 2.6 if you have not already done so:
			http://www.python.org/ftp/python/2.6.4/python-2.6.4_macosx10.3.dmg
			
		Download and install the following Packages:
			http://downloads.sourceforge.net/wxpython/wxPython2.8-osx-unicode-2.8.10.1-universal-py2.6.dmg
			http://downloads.sourceforge.net/project/sox/sox-macosx/14.3.0/sox-14.3.0-macosx.zip
			
	Windows:
		MOUL does this fine on its own under Windows.  Why are you here?
		
Usage -

	GUI Tool:
		1. Either double-click the script SoundDecompress.py, or run it from 
		   the commandline.
		2. Enter your base MOUL folder "Uru Live" or browse to it using the 
		   dialog.
		3. Press Go!

		
	CLI Tool:
		./sounddecompress.py -u /path/to/uru
			This will start running the tool with the standard directory layout.
			If you have another layout, you can override the default
			directories:
			
		-d /path/to/uru/data
		-s /path/to/uru/sfx
		-c /path/to/uru/streamingCache
		
		--xml		-- Will dump audio file listing after audio conversion
					   (defaults to ./wavlist.xml)
		--xmlonly	-- Skips audio conversion; only dumps audio file listing
					   after reading Age files.
		--xmlof		-- Allows override for xml output (implies --xml)
		--xmlin		-- Allows use of xml file instead of reading Age files.
					   Use this option if you have an xml listing for your game
					   version/build and do not have libHSPlasma/PyHSPlasma.
					   
		
		Use -h or --help at any time for a full list of commands.
			
			
			
	For up-to-date information on this script, see the thread on 
	the Guild of Writers forum: 
		http://forum.guildofwriters.com/viewtopic.php?f=86&t=4203			
