==================================================================
Extended New Vegas Radio Generator
by Jarol - [email protected]
==================================================================

This is both a mod and a utility based on the idea of Gamerzworld
Radio New Vegas Extender. It's purpose, just like his, is to extend
the amount of songs on New Vegas Radio that plays on that station.
Instead of being limited by 100 songs, you are now granted the a
single utility that will generate a mod from scratch up to however
many songs you want. Right now it is easily possible to add 50,000
songs to the radio at a push of a button.

Everything has been structured in the same way as Gamerzworld's mod,
so there will be no broken up mod community with this mod. In other-
words the folder/file structure is the same! Also included are built
in ways to convert your music from wav, mp3, ogg, and flac format to
a proper MP3 format, batch rename your files into the proper filenames,
and even convert your final files from MP3 to mono OGG format that
will be used in game for all open world radios.

================================================
Reason/Purpose
================================================

The reason I made this program is a simple one. I want more songs.
Doing things by hand is a pain. Being limited by a set amount is
also a pain. I want however many songs I to play in the game and not
be ignored when making a request (hell you could try saying no).

So of course I did this on my own. I studied on my own and reversed
engineered the esp format to create this program, getting it done in
2 days. Then I patched together a window to enclose it and here it is.

This is not the end of it however. After this release, I am going to
produce an extension on this program that will generate your own
personal radio stations. People who wish to release their own stations
complete with commercial breaks can be done at the push of a button.

================================================
Installation - Basics
================================================

1) Drop to game folder.
=================================
When you open up the rar file, drop the program and Data folder into
the base folder of FONV. Overwrite anything that comes up.

-NOTE-
You should see Extended NVR Generator.exe along with FalloutNV.exe!

2) Generate your Extended RNV Mod!
=================================
Run "Extended RNV Generator". Input the number of songs you want and
set whether you will be using the original Fallout 3 GNR music. Press
"Generate!" and wait for the task to finish.

-NOTE-
You are not limited by one run! You can keep running the program
to replace the mod file with a new one.

3) Copy your music and convert!
=================================
-NOTE-
You've got two choices. To re-encode any music you have to the proper
format (128 CBR MP3) or drop it in as is. I HIGHLY recommend you
re-encode anyway as you can permanently set the volume this way.

-NOTE 2-
FONV only supports CBR (Constant Bitrate) MP3s. You can change the
quality of the music by editing the batch file below.

If you are going to encode your music to MP3, place your music into:
Fallout New Vegas\Data\Sound\songs\radionvextend\MusicToConvert

Then run the batch file labeled "[1. Convert to MP3]". Follow the
instructions on what file format it will convert and the scale
(volume) that you will reduce your songs by. Wait for the process
to finish and you should now have songs in your "radonvextend" folder.

4) Rename your music!
=================================
With the music now in your "radionvextend" folder, go ahead and run
"[2. Rename to xxx]". This batch file will find all MP3s in the folder
and label them from 1.mp3 to XXXX.mp3! Its very quick.

-NOTE-
Be careful! If you run this and you already have songs numbers such
as 1.mp3, 2.mp3, etc., then this process will probably skip or repeat
numbers. A quick fix that you can do is highlight every file,
right-click and rename. It will only show as though only one is being
renamed. Give it a generic name like "renameme" and it will rename all
selected files into "rename (1)", "rename (2)", etc.

-NOTE 2-
If you already have some _mono files. Delete them and repeat the steps
above in the first note! Then apply the below step to recreate them.

5) Create mono OGG files! (Optional)
=================================
If you want your music to also come from in-game radios (not your
Pip-Boy), then you'll need to do this step. Simply run
"[3. Convert to Mono Ogg]" and it will find all MP3s in radionvextend
and convert them to 65kbs mono OGG files with the proper filenames.

-NOTE-
This also works for GNR music! Just copy this batch file and the
"Tools" folder to "radiognr" and run it. Make sure to delete the old
mono wav and mp3 files (should be 40).

6) Enable the mod and play the game!
=================================
You are now done! Use the FONV Mod Manager or just the built in
(now actually functional) Data Files utility on FONV's Launcher.

Remember! if you were using Gamerzworld's mod, please disable it first.

================================================
Other Information
================================================

GNR Radio Importation
=================================
In order to get the music from FO3 into FONV, you must first have the
game and FOMM (Fallout Mod Manager) installed. Once installed you can
use the BSA Unpacker tool found in FOMM to unpack the
"Fallout - Sound.bsa" (or was it Music?) file.

Once you have those files, drag and drop them into:
Fallout New Vegas\Data\Sound\songs\radiognr

After that you can delete the left over mono files (should be 40) and
use the OGG converter batch file (be sure to copy the Tools folder
too!) to make brand new ones for FONV. You DO NOT need to rename
anything The mod only works with the original filenames!

Music Packs
=================================
There are several music packs out there that you can download from
newvegasnexus.com and other various sites to include into your game.
All are compatible, you just have to convert them and rename them using
the steps listed above.

Extended NVR Generator Options
=================================
* Number of Tracks
This is a number from 1 to 50,000. I have limited to this amount
due to common sense. At 50,000 songs, the smallest mod filesize
is 13Mb!
* Unique Mod ID
This is actually the decimal representation of a Hexadecimal. I
don't think many people should have to worry about that so it's a
number you can understand. Just leave it by default. But if
another mod is conflicting, choose a bigger number (it'll stop you
from going too big)
* Randomize!
Randomizes the Unique Mod ID. Its not perfect, but its there. You
don't need to use it.
* Use FO3 GNR Music
Adds the original 20 songs from GNR's music broadcast to FONV. This
does not include commercial breaks ATM.
* Use Ordered Lists
(UNTESTED) This makes the mod follow exactly how music is scripted
in the vanilla game. Supposedly this may make the radio play certain
sections of music in order before randomly playing another set.
Try it if you want. You can always regenerate your mod if it doesn't
work right :P
* Generate!
Generate your mod! You can do this however many times you want. It
will wipe the file clean on every try.

Common Issues
=================================
1) The program is crashing or is giving me errors! (Win7/Vista)
A) If this happens, run the program in Administrative Mode.
Also. Please install FONV somewhere else and not in Program Files!
(steam is fine). Make it a habit to install things in a C:\Games
folder or something.

2) Some songs have very high or low sound!
A) Try using a different scale in the "[1. Convert to MP3]" batch file.
Generally -10db is good for loud music while +10db is good for low.

3) I don't hear anything or all I hear is static!
A) You are probably using an incompatible MP3 format. Be sure it is not
VBR (Variable Bitrate) or ABR (Average Bitrate). Also be sure is not
too high a quality. Generally you are best off with 128kbs for both
performance and quality (its a radio people!)
B) You probably haven't renamed everything. Follow the steps!
C) Make sure the number of tracks is what you have in the radionvextend
folder!

4) My music volume won't change even through the options! (Win7/Vista)
A) You probably need to run the game in Administrative Mode if you are on
Vista/Win7. If this doesn't help, try looking up solutions on how to
clear FFDShow codec problems.

Version History
=================================
11-07-10 - v1.0 - Initial Release!

Last Bits / Acknowledgements
=================================
Thanks to Gamerzworld and his New Vegas Radio Extender for being so damn short!

Also thanks to rarewares.org for providing the software required to encode the audio!

Anything else, just PM me on NewVegasNexus.com or email me at [email protected]!