SubSync preliminary documentation

Text based on SubSync version 0.2.2, so not 100% complete and accurate.

This main window appears when the program is started. There is also a second main window.

Click any control to jump to its description.

Online help is not included, but every control will display a short tooltip when the mouse pointer is hovered above it.

After starting the program, the first thing one will probably want to do will be opening an existing subtitle file and optionally a media file.

AVI:	The full path to a media file can be entered in the text box (this is not limited to AVI files). As soon as a valid pathname of an existing file is entered, that file will be opened. It is easier of course to use the browse "..." button to the right.
SRT:	The full path to a subtitle file can be entered. As soon as a valid pathname of an existing file is entered, SubSync will open the file and try to find out the subtitle type (SubRip, MicroDVD or SAMI). It is easier of course to use the browse "..." button to the right.
Media Player:	Alle usual controls of media player are present. There is no menu in the main window, but right-clicking on the media player will display a pop-up menu with more functions than one will ever need :-)
View subtitles	If this option is selected, SubSync will show the captions in the top right textbox while playing the media, as they would appear (timing) during normal playback.
Position Subtitles	If this option is selected, SubSync will always display the next subtitle to be shown during playback. Title timing can now be entered by pressing the space bar (or another key) at the exact moment when the title should become visible during normal playback later, and keeping it depressed for as long as the title should remain visible.
Next subtitle	THis is where the subtitles will be shown during playback or title positioning.
Sel. Start Sel. End	Part of the media file can be selected for playback or positioning by moving the slider to a certain position, then clicking "Sel Start", moving the slider to a later position, and then clicking "Sel End". Subsequently, the built-in media player will play only the selected part of the file when playback is started. The two textboxes show the exact position in milliseconds of start and end of the selection.
Time:	Shows the current position of the built-in media player. It is possible to enter a new time here to jump to a certain passage when the player is stopped or paused.
Key:	Shows which key will be used to manually position subtitles. (a scan code will be shown instead of the name for most keys). Another key can be selected by clicking in this box and then pressing the desired key.
Edit subtitles	Opens the second window, where the more specialized functions of SubSync can be found.
Save subtitles	Saves the current version of the subtitles in a file (SubRip, MicroDVD or Sami format can be selected).
Exit	What would you expect?

In the EDIT (or LIST) window a list of all subtitles is shown, along with a toolbar which contains SubSync's more powerful functionality.

All functions except for two can be found in the toolbar, the remaining two are accessed through a pop-up context menu that appears when a title is right-clicked (see "Stretch").

One or more titles can be selected in the list. A title is selected by clicking it, multiple titles can be selected by clicking the first and holding down Shift while clicking the last.

Some functions will not be available when more than one title is selected.

Click one of ther buttons to see its description.

Undo:	As the name suggests, restores previous changes. 100 changes are memorized in the undo buffer, but some functions will clear the buffer because they can interact with more titles than the buffer can hold at once (stretch, shift).
Edit	Opens a new window in which text, start and duration of the selected title can be edited. This can also be done by double-clikcing a title. The text can also be changed by clicking a second time on the text of an already selected title, but caution must be taken not to delete the CR or LF code that split a subtitle in multiple lines (the black boxes in the text). It is possible to insert a line break in the edit-window by holding down <Ctrl> when <Enter> is pressed, just pressing <Enter> alone will activate the "OK" button.
Sooner	Moves the start of the selected subtitle(s) 100 milliseconds toward the beginning of the file.
Later	Moves the start of the selected subtitle(s) 100 milliseconds toward the end of the file.
Shorter	Decreases the subtitle duration.
Longer	Increases the subtitle duration.
Stretch	Opens a new window, where subtitle timing can be changed in 3 different ways: - based on the position of 2 subtitles - stretching or shrinking the entire file by a specified amount - stretching or shrinking by converting to another frame rate. Changes are applied to the entire file is only one title is selected, or tot the selected titles only if there are more than one. By right-clicking a title before using this function, it can be indicated as the first or last title of which the exact strating time will be entered using the first method. If no titles are specified this way, the first and last title of the file will be used.
Shift	Allows all titles in the file (if only one is selected) or a selected range of titles to be moved toward the beginning or end of the file by a specified amount.
Insert	Adds a new subtitle before the selected one.
Delete	Deletes the selected subtitle(s).
Stop	Closes this window.