Name: AutoItLIPfileCreator
Version: 1.0
Date: 5/23/2010
Category: Utilities
Requirements: LipGeneration.esp by Gunmaster95, TES CS 1.0.303 and AutoIt3 script tool
Author(s): Nimboss
Source: http://www.tesnexus.com/downloads/file.php?id=8440

Description
===========
Fully automates the process of creating many .lip files for Oblivion and FO3.
Requires Gunmaster95 LIPGenerator.esp and setup to work, Bethesda TES CS 1.0.303 and AutoIt3 a
script tool for automating Windows applications.


Details
=======
This utility or combination of utilities creates a pipeline to automate the creation of .lip files from
a bunch of .wav and .txt files that instruct the utility to use wanted settings and dialogs.


This is totally aimed at advanced modders that can script, like with TES CS and G.E.C.K. Have you used
languages like VBS or Python this will be similar. It might require knowledge of basic programming
and you are demanded to open the script and examine it before running it the first time since this might
save you errors and give you a glimpse on how to fix and expand to fit your needs. This is a general advice
never ever run things you don't know what it contains, that's also why this was not made as a binary only .exe file.


It is mandatory to have setup LipGeneration.esp by Gunmaster95 and made that work before installing AutoIt3
and this utility script.

As stated this require you to have setup and running the first TES Construction Set ver. 1.0.303 since that is
the only one that .lip creation works on.

Tested on Windows XP, Vista 32bit, 7 64bit and works, see other known issues and bugs below.


NOTE This is a beta, I have tested it on my machines but for sure my setups will not confirm to how everyone
else have setup their environment.


NOTE 2 Of course this is usable for Oblivion modders also and since there is a lot of more mature mod
creators on Oblivion they might see the benefit for this tool even more than general FO3 modders.


Format of the .txt files that follows the .wav file (notepad style)
1st line the spoken dialog exactly as it should be .lip synced, spelled correctly
2nd line the mod like Neutral, Angry, Happy, Sad, Disgust, Surprise, Fear.
3rd line the mod level 0 to 100, 50 default.
extra lines after these is not used and can be used for detailed instructions to the voice artist.




Example:
Hello! It's You!
Happy
80
Long lost friend in view..



Install
=======
1. As stated this require you to have setup and running the first TES Construction Set ver. 1.0.303 since that
is the only one that .lip creation works on.
2. Download LipGeneration.esp by Gunmaster95, and have that working before you continue.
3. Download and install AutoIt3 a script based tool that let you script control mouse and keyboard.
4. Download and unpack this utility and place the file AutoItLIPfileCreator.au3 in Oblivion folder.
5. Create a new folder in Oblivion folder named CreateLIPsFolder
6. Put prepared .wav files in CreateLIPsFolder together with .txt files named the same as the .wav file that
contains the dialog and instructions for the compilation.
7. Fire up the script or run it from the Editor that is included with AutoIt3 (recommended).
8. After walking through all files and creating the ones that don't have a corresponding .lip file it closes
CS down and let you know how many files it created. The .lip files are saved in the CreateLIPsFolder.

You find TES CS 1.0.303 here:
http://www.elderscrolls.com/downloads/updates_utilities.htm

You find Gunmaster95 tutorial and .esp here:
http://www.fallout3nexus.com/downloads/file.php?id=11802

To download AutoIt3 you have to visit this place:
http://www.autoitscript.com/autoit3/index.shtml




Uninstall
=========
1. AutoIt3 is uninstalled with the normal Windows Program manager. But I think since you seen what you can do
with it you want to keep it.
2. Delete the AutoItLIPfileCreator.au3 and the folder CreateLIPsFolder in your Oblivion game folder.










Known Issues or Bugs
====================
1. You must have something plugged into your PC mic input if you run Windows Vista / 7 or otherwise TES CS will poff CTD.
2. When running TES CS native without the full install of Oblivion it will always CTD when finished, that's normal
as long you get the message about how many .lip files was created.
3. With a full Oblivion install the Spell Check dialog will hit in if it don't like your dialog spelling, I have made
some efforts to kill it but there seems to be some work left to get rid of it.
4. Lots of paths and names are hard coded in the script, if using on a different computer setup you need to change
these parts in the script.
5. Of course running this within the default \Program Files fodler and with UAC will create headaches and don't work.
6. Not sure how it will handle paths with spaces or non english languages, the tool is said to handle UTF.
7. LipGeneration.esp must be timestamped by OBMM or similar to be last in .esp list, otherwise the simple automated
script will fail to load the right master.

Please, put any found bugs or issues on the release thread so others can make use of this information and I got a
chance to fix and release updates.

History
=======

1.0, 2010/05/23 - Initial release.

Contact
=======
You can find me on The Nexus Forums as 'Nimboss'

Credits
=======
Thanks to Bethesda for creating Oblivion.
Thanks to Bethesda for creating Fallout3.
Thanks to TESNexus.com for the a one-stop-shop resource for authors and players.
Thanks to LHammonds for the Readme Generator this file was based on.
Thanks to Gunmaster95 for the resources needed to make this automated script.
Thanks to all people that put hard work into modding and sharing knowledge and mods that makes these games
into a new experience everyday.

Tools Used
==========
Readme Generator - http://lhammonds.game-host.org/obmm/tools_readme_generator1.asp
AutoIt - http://www.autoitscript.com/autoit3/index.shtml

Licensing/Legal
===============
This is only uploaded on The Nexus family site, and I don't want to see it anywhere else. The reason is to
have one place to update and support, and because I like TesNexus.

Currently I don't plan to die but if, and I do not respond within 1 month, feel free to do whatever you like
with this utility as long as you release renamed versions on TesNexus for everyone to use.