==================================================================================================== Music Installer OBMM Script ==================================================================================================== Version: 1.1 Author: Surazal Date: 1 November 2009 ============ Introduction ============ I enjoy adding additional music files to my game, but prefer retaining the original Oblivion music as well. I also found that many music compilations did not have the files stored in their relevant folder structures, which made installation and removal hard work. To address these issues, I created a template folder structure so I could move the music files into their appropriate folders and wrote a script that gave me the option of installing the new music without overwriting the original music files. =========== Description =========== This .rar file contains a script to help install music files without overwriting the original Oblivion music. The script provides you with the option to overwrite the existing music at activation time. The .rar file also contains a template folder structure for music files. You are meant to copy folders from the extracted Music Installer OBMM Script to the folder containing the music you downloaded - the Music Installer OBMM Script does NOT contain any music files. ============ Requirements ============ Oblivion Mod Manager (OBMM): http://www.tesnexus.com/downloads/file.php?id=2097 - Required for using the Music Installer OBMM Script with your music files =============== Recommendations =============== Enhanced Music and Control: http://www.tesnexus.com/downloads/file.php?id=19772 - Provides enhanced music effects such as fading between tracks and resuming a previous track from earlier. ============ Installation ============ Do NOT create an OMOD from the Music Installer OBMM Script .rar file - it contains script and an optional music folder structure for use with the music compilations you download. 1. Extract the Music Installer OBMM Script .rar file to permanent folder on your system (NOT the Oblivion Data folder) 2. The Music Installer OBMM Script is now ready for use - see the next section. ============================== Using the OBMM Music Installer ============================== 1. Extract your downloaded music compilation to a temporary folder. 2. Copy all the folders from the Music Installer OBMM Script to the temporary folder above. - Answer yes to any replace messages (an empty Music folder structure is copied as part of the process) 3. Ensure the temporary folder contains a valid "Music" folder structure - Use the template Music folder structure copied in step 2 to arrange the music files appropriately 4. Use OBMM to create an OMOD for your music compilation from the temporary folder used in step 1. 5. Once it has finished, double-click the newly created omod in your list to install the music files. Notes ----- If a Music folder is NOT present in your omod, you will see this error message... Invalid arguments to 'For Each DataFolder' Directory 'Music' is not a part of this plugin on line 27 Simply correct the problem in your temporary folder by defining a Music folder and re-create the omod (see steps 3 to 5 above). Changing the prefix ------------------- "MI_" is the default prefix and there is NO requirement to change it. However, you can change this by editing the script before you press the Create button and amend the 'SetVar vPrefix "MI_"' line to 'SetVar vPrefix "Your_Prefix"'. I usually change it to help me identify the music compilation I am installing (eg "AEterna" for "AEterna Symphonic Music"). ==================== What the script does ==================== You don't need to read this to use it - just here for information :) 1. Does as much validation on the OMOD as possible (folder structure, MP3 files present, etc). 2. If there are any problems, displays a list of all issues detected so you can correct the problems. 3. Displays a dialogue that allows you to change the default behaviour - Only if there are conflicts with the original Oblivion music files 4. Copies the music files to the relevant Oblivion Data\Music folders and renames the files if required. - No prefix is added to the file name when there are no conflicts with the original music files. Notes ----- If the script detects that a file using the prefix is already installed, it will append additional characters to make the file name unique. For example, suppose you have two music compilations that both update "battle_01.mp3"... - First compilation installed will use "MI_battle_01.mp3" - Second compilation installed will use "MI_1_battle_01.mp3" ============== Uninstallation ============== 1. Delete the Music Installer OBMM Script folder you created on your system. ================================ Known Bugs and Incompatibilities ================================ None so far. =============== Version History =============== 01 Nov 2009: v1.1 - Only displays option dialogue when there are conflicts with the original Oblivion music files - Does not add a prefix to the music file names when there are no conflicts 23 Oct 2009: v1.0 - Initial release ===== Legal ===== You are free to re-use or change this script providing you give me some credit for the work I've done and, of course, credit the people in my credits section. ================== Credits and Thanks ================== Timeslip - for his wonderful Oblivion Mod Manager (OBMM) _____________________________________________________________________________________________________________ _____________________________________________________________________________________________________________ Surazal