====== ProjectX ======

ProjectX tries its best to handle & repair many stream types and shows what went wrong on reception. This is very useful for repairing MPEG files, especially with audio and video syncronization problems. 

===== Installing Java =====

Java must be installed to run the ProjectX executable binary. How this is done for your computer will vary. Here are some guides for specific operating systems on how to install Java. 

==== Ubuntu/Kubuntu/Xubuntu ====

Enable the universe in your apt-source list. From a root console or via sudo use nano/vim/gedit or whatever text editor you like to open: /etc/apt/sources.list. You should either have the "universe" enabled on one of your repository lines.

After you have made sure the "universe" repository is enabled in your apt-sources file, from a root console or via sudo run this command:

 sudo apt-get update

Next we will install Java itself. Run this command line from the root console with either su or sudo:

<code>sudo apt-get install sun-java6-bin</code>

===== Downloading ProjectX =====

ProjectX is written using Java and can be run on almost any platform. You can download binary execute jar files from [[http://www.doom9.org/|Doom9.org]] in their **Downloads** section.

===== Extracting ProjectX =====

After you have downloaded the ProjectX binary zip file, you need to extract it. How you do this will depend on your operating system. In most Linux/BSD systems it can be done with the //unzip// command. Like in this example:

<code>unzip ProjectX_0.90.4.zip</code>

===== Running ProjectX =====

After you have downloaded ProjectX, you can simple run it. Exactly how you run the program will depend on your operating system.

==== Linux/BSD ====

In Linux and BSD variant system, that have contain a full and valid console enviroment, you can run ProjectX using the command line. From a command console, make sure your current console prompt is actually working the same directory as the ProjectX .jar file or that the .jar file is in your system path, then run this command:

<code>java -jar ProjectX.jar</code>

ProjectX should now open.

==== Windows ====

If you are using Windows, usually you can simply //double-click// on the **.jar** file. Alternatively you can select it and then //right-click// to open the mouse-menu and select **Open** to start the file. By default Java, if it is properly installed, should run the application for you. 

===== Problems =====

==== Ubuntu ====

If you are using Ubuntu and you had error when you tried to run ProjectX from the console, you may need to run the following commands to configure Java (either as **root** or using **sudo**):

<code>sudo update-alternatives --install /usr/bin/java java /usr/local/java/bin/java 3
sudo update-alternatives --config java</code>

If this does not fix your errors when executing, please refer to the Java install page [[https://help.ubuntu.com/community/Java|here]].

===== SourceForge.net =====

ProjectX is a SourceForge project. News and updates to the program can be found at [[http://sourceforge.net/projects/project-x]]. This website does not contain a pre-compiled binary executable file and it may require you to create it if you want to use their version. Usually the regular binary files are up-to-date and current with very recent code releases.