View source for FreeSpace Open Installer

The FreeSpace Open Installer is currently the only official online installer for FS2_Open.  The Installer was originally written by Turey, and then completely rewritten by Goober5000.  The source code is hosted by the [[SCP]].

The program's web page is [http://www.fsoinstaller.com/ here].

== Features ==
The most recent Installer includes:

* FreeSpace Open 3.7.0 Final (regular and debug)
* FRED2 Open 3.7.0 Final (regular and debug)
* Launcher 5.5g
* Linux 32-bit and 64-bit Executables
* Mac Executables
* The OpenAL Installer (optional)
* 3.6.12 MediaVPs
* .OGG Cutscenes
* Derelict SCP Version (With optional voice)
* FreeSpace Port
* Silent Threat: Reborn
* Homesick
* Transcend
* Sync

== Walkthrough installing ==
<!-- Someone help me clean this up -->

This Installer is known to work on Windows, Linux (tested on OpenSuse, Gentoo and Fedora, should work on others), and Mac (OSX Panther, with a hacked install of Java 1.5)

First step is getting Retail FS2. You can buy it from either [http://www.gog.com Good Old Games] or off of eBay or something. Install it and the related patch, then get the FreeSpace Open Installer.

=== Requirements and Notes ===
You can update your installation by simply running the Installer again. It will download files that are out of date.

The Installer requires an internet connection to install. This is because:
* It checks to see if it is out of date by pulling the number of the most recent version off of the web.
* It automatically takes you to the download page of the most recent version if your version is out of date.
* It checks that all the files are up-to-date.
* This install process downloads several GB of data, if you download everything.  Just so you can prepare; for example, you could set it to download while you are working on something else.

=== Download Links ===
* [http://www.fsoinstaller.com/files/installer/FreeSpaceOpenInstaller.jar fsoinstaller.com]
* [http://scp.indiegames.us/installer/FreeSpaceOpenInstaller.jar scp.indiegames.us]

Both links contain the same installer.  The program requires Java version 1.5 or higher, and can be run on any operating system that can run a compatible version of Java.

You can also get the source code from the SCP's SVN repository at svn://svn.icculus.org/fs2open/trunk/fsoinstaller.

=== Install procedure ===
# Install FreeSpace 2 from your disks, if you haven't already. Install it to C:\Games\FreeSpace2.  Then install [http://www.pxo.net/files/fs21x-12.exe the 1.2 patch].
# Now, put disk 2 of FreeSpace 2 back into your CD drive.
# Copy all the files with the extension of ".MVE" from the disk root directory ( \ ) to the folder C:\Games\FreeSpace2\data\movies\ (create this folder if it doesn't exist)
# Do the same thing for disk 3.
# If you ONLY have the FS2 disks, then put [http://www.fsoinstaller.com/files/installer/installedversions.txt this file] (right-click Save Target/Link As) in C:\Games\FreeSpace2\Installer\ (create this folder if it doesn't exist)  If you have BOTH the FS1 and FS2 disks, skip to the next step.
# If you don't have the Descent: FreeSpace a.k.a. Conflict: FreeSpace (aka FS1) Disks, then skip to the last step.  If you do, insert disk 1 in your CD drive.  Copy all of the files with the extension of ".MVE" from the disk directory \Data\movies\ to the folder C:\Games\FreeSpace2\fsport\data\movies\ (create this folder if it doesn't exist)
# Do the same thing for disk 2.
# If you ONLY have the Conflict: FreeSpace a.k.a. Descent: FreeSpace (aka FS1) disks (and not the FS2 disks), put [http://www.geocities.com/joshuap_richards/Installer_FS1/installedversions.txt this file] (right-click, Save Target/Link As) in C:\Games\FreeSpace2\Installer (create this folder if it doesn't exist)  If you have BOTH the FS1 and FS2 disks, then skip to the next step.
# Run the Installer, under the "Installing the FreeSpace Open Installer" section, above.

==== Using the Installer ====
# First window, click next.
# Press "Next" again, or click the big button to change the location for the FreeSpace 2 install.  (Don't, unless you have a reason to, e.g., you really want another location or you've already installed Retail FS2 to a different directory than C:\Games\FreeSpace2.)
# Make sure "Update Installed Sections Only" and "Say Yes to All" are not checked.  Then hit "Next".
# <!-- 4-6. -->If you are a Windows user, select everything, except for "Macintosh (Universal Binary) Executables", "Launcher for OS X", and the two "Linux Executables" sections. If you are a Mac user, select everything, except for "Windows Executables" and the two "Linux Executables" sections.
# Wait for the Installer to finish (this may take a long time!).  You will know it is done when the "Next" button becomes black, instead of gray.
When it becomes black, click it. This means the installation is finshed.
# READ the NOTES!!!  They might contain important information. After you do, hit "Exit".
# Hit the Close button on the Command Prompt Window.

OpenAL notes:
# <!-- 10-11 --> If you don't have it, get OpenAL: (all users, Windows / Mac / Linux) Go to www.openal.org, and click on the "Downloads" link on the left.
# Get the correct version for your OS:
Windows users get "1.1 Installer for Windows" - 
Note: If you're using Windows, and you have nvopenal.dll or ctoal.dll in your Windows\System32 directory, then delete them and then install the newest version of OpenAL. These files are older versions, and will cause problems with the new install.
Mac users get Installer for OS X.
Linux users get the Binary RPM, or compile from the source code.

If you have any issues with the installation post [http://www.hard-light.net/forums/index.php/topic,47045.0.html here].




<!-- Old information  Parsing through this before deletion

The FreeSpace Open Installer is an attempt to significantly reduce the difficulty of installing FreeSpace Open over a Retail FreeSpace 2 installation. The Installer was coded by Turey, originally using the [http://nsis.sourceforge.net/Main_Page NSIS] scripting language, but was re-written in Java as of December 12, 2006. The first version was released on October 16, 2006, and the latest versions of the exe and the source code can be found at [http://www.fsoinstaller.com fsoinstaller.com].

More information about the Installer can be found on [http://www.hard-light.net/forums/index.php/topic,42854.0.html Hard Light Productions].

=Features=
The Installer is designed to be one-size-fits-all, so that dial-up users can have a small Installer that only installs the necessary files, while broadband users can have an Installer that downloads all the extras for them.
The Installer automatically checks to see if it is outdated, and will bring up the download page of the newest version if it is outdated.
The first version of the Installer included only the Executables and the MediaVPs. Since then, many other parts have been added and refined.

==FreeSpace Open Executables==
The Executables were originally packaged as part of the installer, which added about eight megabytes to the size of the Installer. However, as of the 3.6.9 - RC 7.9x version, the Executables have been taken out of the Installer file and are downloaded at runtime.

==OpenAL==
One of the most common problems people have installing FreeSpace Open is that they do not install OpenAL. From the first version, the Installer has had an option to download and run the OpenAL installer automatically. This feature has temporarily been disabled, but will be re-enabled in the future. In the meantime, you can get OpenAL [http://fs2source.warpcore.org/exes/latest/OpenALwEAX.exe here].

==MediaVPs==
The MediaVPs are a set of graphical enhancements to FreeSpace Open, created by the [http://www.hard-light.net/forums/index.php/board,120.0.html FreeSpace Upgrade Project]. These upgrades have been included since the first version, and as of version 3.6.9 - RC 7.9x, they use the Mod Installation System (see below).

==Mod Installation System==
The Mod Installation System is a feature that first made its appearance in version 3.6.9 - RC 7.9x. The system allows the creator(s) of a mod or campaign to include their work in the Installer, so that it can be downloaded and installed at the same time as FreeSpace Open. By interfacing with text files, the Installer can get the most recent files for each mod directly from that mod's web site. This allows mod creators to update their files at any time, without the need for a new release of the Installer.

Help with the Mod Installation System can be found at [http://www.fsoinstaller.com/modhelp.html fsoinstaller.com]

Mods and Campaigns currently included in the Installer can be found at [http://www.fsoinstaller.com fsoinstaller.com].

=Version History=
Visit the [http://www.fsoinstaller.com/changelog.html changelog on www.fsoinstaller.com].

-->

[[Category:Source Code Project]]