This mod allows you to replace "XCOM: Enemy Within" music with your own mp3 files.

This mod will only work on Windows PCs.

INSTALLATION
============
 
1. I recommend that you install this mod (XComMusicTool.txt) using Long War Mod Manager (http://www.nexusmods.com/xcom/mods/620/?). Alternatively you can use PatcherGUI 7.1 or better if you wish. 
2. Create a folder on your PC, e.g. c:\XCOMMusic and copy XComMusic.exe (included in this mod) there.
3. Run XComMusic.exe - it will create the following subfolders (relative to where you ran it from):
  
CombatMusic              - Music played while in combat
BackgroundMusic          - Music played during a mission (while not in direct combat)
HQSoundTrackAct1/2/3     - Music played while at HQ
InterceptionMusic        - Music played during the UFO interception mini game
Memorial                 - Music played while viewing the soldier memorial in the barracks
MissionControlSoundtrack - Music played while at mission control (Geoscape)
ReadyForBattleMusic      - Music played while loading your squad into the Skyranger
CreditMusicWin           - Music played if you win the game
YouLoseMusic             - Music played if you lose the game
 
Copy one or more mp3 files into each of these folders. If you have more than 1 file in a folder, then one will be picked at random (if shuffle mode enabled) whenever that type of music is required. You may create additional sub-folders within these folders and they will be scanned for music files too.
 
4. Make sure that XComMusic.exe is running, then start XCOM: Enemy Within. Set the music volume in the game to 0. While XComMusic.exe is running it will detect any music played by the game and play an appropriate replacement file instead.

You can download the original XCom music from here:
http://downloads.khinsider.com/game-soundtracks/album/x-com-enemy-unknown
  
That's it!

Here's a sample with some old school Ministry used as combat music:


Here's a sample video of the mod in action. I used music from the Dark Souls II soundtrack:

  
OPTIONS
=======
As of version 1.0c, you can now control music volume and track skipping via these optional hot keys (they will work while you're in the game):

         Ctrl+Alt+Shift B = Skip to next track
         Ctrl+Alt+Shift N = Volume down
         Ctrl+Alt+Shift M = Volume up

Loop option - If enabled the same track will keep looping until the game requests another music type.
Shuffle option - If enabled tracks will be picked at random, otherwise the tracks will be played in order (sorted by file name)

HOW IT WORKS
=============
This patch makes the game write an entry to the internal log file every time music is started or stopped. The XComMusic.exe program monitors this log file for these new music log entries and plays or stops playing its own mp3 file whenever it finds one.
  
Version history:
1.0a initial release
1.0b Added support for "background" music during a mission
1.0c Added optional hotkeys for volume + track skipping, loop option, shuffle option. Additional subfolder support. Play history tracking.
1.0d Music tracks of a particular type (e.g. BackgroundMusic) will now resume from where they stopped instead of starting a new track of that type. You can force it to start a new track each time by enabling the "New track on music change" option. If the same song is used for a different music types (e.g. for HQSoundtrack and MissionControlSoundtrack) then the song will continue playing without being stopped first when the game switches between the different music states. Tracks will now fade out and back in instead of stopping and starting abruptly.