README.txt~

SE206
=====

To run this program there are vlcj Libraries that must be referenced by the programme. These can be found at http://www.capricasoftware.co.uk/ in the downloads section. Once these libraries are installed the programme should run correctly.
When the program is running it opens on a media player which has a menu bar at the top, a dock containing buttons at the bottom and a blank screen in the middle.

To Open a video click on media in the menu and select "Open File...". As soon as the file is open it will start playing. To pause the video press the play button, which has both pause and play functionality. To fast forward press the forward button and press rewind to go back through the video. To stop the video press the stop button. Each of these buttons have a twin in the menu bar under playback. To mute the audio press the mute button, there is a mute component in the menu under the audio menu.

To Download a video click on media in the menu and select "Download File...". URL allows the user to enter/paste the URL of the video to be downloaded. The open-source checkbox should be ticked if the video to be downloaded is open-source. The Save As field allows the user to select the location to save the file as well as specify the name of the output file. Clicking the download button will start the download process and the progress bar. IF the open source checkbox is not ticked, the mediaplayer will refuse to download the file. If the file already exists, a pop-up will give the user warning, and ask if the file should be overriden, resumed (to download), or if the operation should be cancelled. The progress bar will stop once the process is completed, and a pop-up confirmation will notify the user whether the process was successful, and if not, what could have caused the problem. 



AUDIO FUNCTIONALITIES
Extract Audio
Video file input allows user to select the video file to extract the audio from. Save As allows the user to choose where to save the output audio file to, as well as specify the name of the audio file. Both fields can be edited in the text field, as well as by using the GUI file chooser. Once both fields are completed, clicking the extract button will start the extraction process and the progress bar. If the user has not entered the file extension (.mp3), it is automatically added when the user clicks the extract button. The progress bar will stop once the process is completed, and a pop-up confirmation will notify the user whether the process was successful, and if not, what could have caused the problem.

Replace Audio
Video file input allows user to select the video file to extract the audio from, and audio file input allows user to select the audio file to replace the video's audio track. Save As allows the user to choose where to save the output video file to, as well as specify the name of the video file. All three fields can be edited in the text field, as well as by using the GUI file chooser. Once all fields are completed, clicking the replace button will start the replace process and the progress bar. If the user does not enter the file extension (.avi), it is automatically added when the user clicks the replace button. The progress bar will stop once the process is completed, and a pop-up confirmation will notify the user whether the process was successful, and if not, what could have caused the problem.

Overlay Audio
Video file input allows user to select the video file to extract the audio from, and audio file input allows user to select the audio file to overlay over the video's audio track. Save As allows the user to choose where to save the output video file to, as well as specify the name of the video file. All three fields can be edited in the text field, as well as by using the GUI file chooser. Once all fields are completed, clicking the overlay button will start the overlay process and the progress bar. If the user does not enter the file extension (.avi), it is automatically added when the user clicks the overlay button. The progress bar will stop once the process is completed, and a pop-up confirmation will notify the user whether the process was successful, and if not, what could have caused the problem.



SUBTITLE STUFF
Create A Title Scene: 
Click on Subtitle in the menu. Choose "Create Title Page". Choose the video file you would like to add a title to. Choose where you would like to save the output and the output name. If the name already exists you will be given the option to choose a new name or override the file. On the Add Title Scene window choose your text and properties from the drop down menu. To see a preview click preview, this takes a little time to load. Once satisfied with your choices click enter. A progress bar will appear and when it is finished your title is added.

Create A Credit Scene: 
Click on Subtitle in the menu. Choose "Create Credit Page". Choose the video file you would like to add a credit to. Choose where you would like to save the output and the output name. If the name already exists you will be given the option to choose a new name or override the file. On the Add Credit Scene window choose your text and properties from the drop down menu. To see a preview click preview, this takes a little time to load. Once satisfied with your choices click enter. A progress bar will appear and when it is finished your credit is added.

Edit A Title or Credit:
Click on Subtitle in the menu. Choose "Edit Title or Credit". Choose which file ou would like to edit. A file cannot be edited if it has not been givan a tile or credit page, if the original file was deleted, if the log was edited or deleted or if any names were changed. A screen, the same as in the create title or create credit scene, will open with the text box already filled with the text it contains. The dropdown menus must be reset to tour choice. To see a preview click preview, this takes a little time to load. Once satisfied with your choices click enter. A progress bar will appear and when it is finished your text is added.