-----------------------------------------

Running Krut on Windows

-----------------------------------------

Here are some quick instructions on how to run the program on the newer versions of Windows. (You need to have Java installed, but there is a good chance that you already do. Otherwise, see below.) 
 
To run the program, it is usually sufficient to just double click on "KRUT.jar" or "krut.bat", after you have extracted the zip-archive into a folder of your choice (you have to extract the archive somewhere). 
 
If you double click "KRUT.jar", and the program doesn't start, but you get a list of programs to choose from instead, you should choose the one that says "Java (something)". If you click the "always use the selected program..." check box at the bottom of the list, you will not have to repeat this step the next time you want to run the program. 
 
If double clicking does not work at all, try right clicking and see if there are any "Open With"-alternatives. If there is an "Open With -> Java (something)" alternative, that should do it. Again, if you click the "always use the selected program..." check box, you will not have to repeat this step the next time you want to run the program. 
 
If there is no "Open With" alternative when you right click, try to hold down a Shift-button while you right click, and see if there is an "Open With" alternative now. 
 
If none of this works, there is probably some problem with your Java-installation. Go to a Java download site (at the time of writing http://www.java.com/getjava), and download and reinstall your Java.



-----------------------------------------

Video recording

-----------------------------------------

Video can be recorded at a given frame rate (fps), and played back at another. If the recording fps is changed, the playback fps will be changed along with it, so the playback fps must be changed afterwards.

The capture area on the screen is chosen like this:
- Press either one of the mouse pointer buttons (in the main window or in the Settings window)
- Move the mouse to the TOP LEFT corner of the capture area.
- Press and hold CTRL.
- Move the mouse to the BOTTOM RIGHT corner of the capture area.
- Release CTRL.

The capture area can also be set manually in the Settings window. The capture area can be checked by clicking the "Snap" button, before recording.

For a description on how to disable graphics overlay to enable video recording from a media player using graphics overlay, see the readme-files and video files.



-----------------------------------------

Sound Recording

-----------------------------------------

For a general description on how to enable sound recording, please see the readme-files in each release.

The sound recording can currently only be done in the wav format. Encoding in other formats might be added. In the mean time, the recorded wav-file can be used for manual encoding into whatever format is wanted. If a suitable encoder for the mp3 format is released for in java, it is very likely that it will be added to Krut. At the time of writing, no such encoder has been found.

Sound synchronization works by comparing the recorded time of sound to the system clock. Since video synchronization uses the same principle, this will ensure that sound is synchronized to video, as long as sound synchronization is active. However, if the system clock and the clock of the device playing the sound run at different speeds, this may mean that both sound and video are recorded at the wrong speed.

If video recording and video playback are set to different frame rates, sound will stay synchronized to the video track, instead of the system clock.

Sound synchronization is necessary to maintain sync between audio and video in longer movies, since random frames will inevitably be lost in the recording process.

The other settings for sound recording should hopefully be self explanatory.



-----------------------------------------

Files

-----------------------------------------

Files can be selected by either entering the file name directly into the file name field in the Settings window, or by using the browser for each file. If the “overwrite save files” check box is checked, the written files will have the chosen file names, otherwise the program will find the first available file name by adding numbers.

The following files are produced by the program:

Audio files	-	wav files containing the recorded audio tracks.
Image files	-	jpg files containing the recorded snapshots.
Movie files	-	mov files containing the recorded movies.

In addition to these files, mov files of the names temp1.mov, temp2.mov etc. are produced, containing only video data. These temp files are located in the same directory as the movie files. If there is no audio recording, only the temp files will be produced.

After recording, the temp files and the audio files can be used to create new movie files using other software.

All the files mentioned so far will remain after the program is closed, and will have to be deleted manually.

There are also temporary storage files created in the home directory of the program. These files will remain after the program is closed, but they will contain no data.