AgathaRadio v1.1
by PimpBot420


This mod attempts to implement a stable Agatha's Radio songlist extender.
Agatha's available songs have been expanded with the option of retaining the
original 12 song tracks in rotation. The song memory list has been increased to
prevent tracks from repeating too often. Intro memory list has been increased
from 1 to 4.

[S] Standard Edition: Songs played until Agatha begins speaking again has been
    increased from 1 to 2.
[E] Extended Edition: Songs played increased to 3.
[C] Classic Edition: Songs played remains at 1.
[SR] Standard Remover Edition: Songs played set to 2, original 12 songs removed
     from playlist.
[ER] Extended Remover Edition: Songs played set to 3, original songs removed.
[CR] Classic Remover Edition: Songs played remains at 1, original songs removed.

This mod does not include the mp3 files you need to extend Agatha's song
library. Those will be user supplied.


Installation
------------
1) Select one version of AgathaRadio.ESP from rar file
2) Place sound folder and selected ESP into folder ...\Fallout 3\Data
3) Place audio files* in folder ...\Fallout 3\Data\Sound\Songs\Radio\Agatha
4) Start game using FalloutLauncher or FOMM**
5) Place checkmark next to your selected AgathaRadio.ESP

*See Preparing Your Audio Files section below.
**See Helpful Files section below.

Uninstallation
--------------
1) Delete selected AgathaRadio.ESP from folder ...\Fallout 3\Data
2) Delete folder ...\Fallout 3\Sound\Songs\Radio\Agatha


Preparing your audio files
--------------------------
AgathaRadio requires a certain number of audio tracks to function properly.
Select the correct version to accomodate the number of MP3s you wish to play.

Prepare your audio files as described below. "x" denote optional steps.
1)  Collect your MP3 tracks to be used.
2)  Set quality to CBR, 192kbps, stereo, 44kHz.*
3x) Set volume normalization. 92.9db will match Agatha's original songs.**
4)  Place MP3s in folder ...\Fallout 3\Data\Sound\Songs\Radio\Agatha
5)  Run "MP3 TrackX Namer.BAT". This will rename your MP3s in the correct format
    for Agatha. This will also create 2 files in the folder. TrackXUndo.BAT will
    return your MP3s to original titles. SongList.TXT is for your reference.
6)  Create mono MP3 files of your renamed tracks. CBR, 96kbps, mono, 44kHz.*
7)  Place "Mono Extension Adder.bat" in same folder as mono MP3s. Make sure this
    folder does not include your stereo MP3 files.
8)  Run "Mono Extension Adder.bat". If you need to undo this step, please run
    "Mono Extension Remover.bat".
9)  Place mono MP3 files in folder ...\Data\Sound\Songs\Radio\Agatha
10x)Check to make sure you have 2 files for each track you wish to play.
    For example: Track01.mp3 | Track01_mono.mp3

*See Bitrate Information section below.
**MP3Gain can accomplish this. See Helpful Files section below.


Bitrate Information
-------------------
Please note that using MP3s of varying bitrates may cause songs to stutter,
skip, and repeat sections before ending.

MP3 - CBR, 192kbps, stereo, 44kHz
MP3 - CBR, 96kbps, mono, 44kHz

MP3 bitrates can be set using many free bitrate converters available online,
Switch Sound File Converter can be used for this purpose. See Helpful Files
section below.


Suggested audio configuration
-----------------------------
If FFDShow audio filter is installed, set Fallout.exe to "Don't use ffdshow in."
If AC3Filter is installed, set to "Use DirectSound by default" under system tab.
If MADFilter.ax is installed, remove it from registry.
Has been tested with K-Lite Codec with no issues.
Has been tested with Windows XP default codec with no issues.


Version History
---------------
1.0 - Initial release.
1.1 - Included new track naming BAT files.
      New bitrate recommendations.
      Released [CR], [ER], [SR] editions.

Incompatibilities
-----------------
This file is incompatible with any mod that changes the entries for Agatha's
Radio's songs list.

Changed Entries
---------------
SCPT (MS17RadioScript)
DIAL (RadioHello)
Dial (RadioGoodbye)

Bug History
-----------
None known.

Helpful Files
-------------
Fallout Mod Manager (FOMM): timeslip.chorrol.com/fomm.html
K-Lite Codec: www.codecguide.com/download_kl.htm
MP3Gain: mp3gain.sourceforge.net/download.php
Switch Sound File Converter: www.nch.com.au/switch/mp3.html

Legal
-----
If you would like to use this mod in your own, please contact me first. I am
always happy to allow use, but I do like to be notified of it. Contact
information is found below, thank you for your understanding.

Contact Me
----------
PimpBot420 on Fallout3Nexus
larrydust2@hotmail.com