/////////////////////////////////////////////////
// This file is part of Sears project.
// Subtitle Editor And Re-Synch
// A tool to easily modify and resynch movies subtitles.
/////////////////////////////////////////////////
//This program is free software; 
//you can redistribute it and/or modify it under the terms 
//of the GNU General Public License 
//as published by the Free Software Foundation; 
//either version 2 of the License, or (at your option) any later version.
/////////////////////////////////////////////////
//Sears project is availbale under sourceforge
// at adress: http://sourceforge.net/projects/sears/
//Copyright (C) 2005 Booba Skaya
//Mail: booba.skaya@gmail.com
// 
// $Id: README.txt,v 1.6 2005/12/04 16:31:01 booba_skaya Exp $
////////////////////////////////////////////////

1)INSTALLATION
2)GUI-UTILISATION
3)COMMAND LINE UTILISATION
4)BUG REPORT, MORE HELP



1)INSTALLATION
You must have java installed on your machine to run Sears.
To verify that java is working on your computer, open a command window and type:

"java -version"

It should return:

java version "1.4.2-02"
Java(TM) 2 Runtime Environment, Standard Edition (build Blackdown-1.4.2-02)
Java HotSpot(TM) Client VM (build Blackdown-1.4.2-02, mixed mode)

or something like that.

If not, you can find java last JRE (JRE 5) on http://sun.java.com


then:

Decompress zip archive in a folder.
simply launch Sears_0.X.sh or Sears_0.X.bat (depending on your system).

2)GUI-UTILISATION
Using Sears could be quite simple if you know what you want to do. \o/

First is to open the Srt file you want to modify.
Menu File>Open, to choose the file to open.

Once opened, the sub-titles should appears in the table.

Then depending on what you want to do:

*Delay some ST (ST=Subtitles):
Select the ST you want to dely, and use menu:
Action>Delay...
Enter the delay you want to apply (positive of negative delay) in seconds.
Press OK, the delay has been applied !

*Resynchronize whole file.
This is the miscelaneous feature.
You will need to iopen your favorite video player, watch your movie, and select Two subtitles as far as as possible from each other. 
The best would be the first and last sentence of movie.

You have to get the real time of these two sentences, the time you want to see the ST.
You can use player's time line.

Once these two times hopefully noted on a post-it, select the two ST you have picked up in the table, using Crtl+click to have multiple selection.

Click on Action>Resynchro...
A dialog will open, asking you some info.
Source 1 and Source 2 should be filled with Time of the two selected ST.

You will just have to fill the Destination 1 and Destination 2 text fields.
Be sure to respect Time format.

And click OK.

The Two sentence you would like to resynchronize are resynchronized, and ll the file has changed, to keep synchronization.

*Split your file.
You can split your file in two part, just select the ST that will delimitate the files.
Click on Action>Split.
A dialog will open, asking you some infos.
Just select the two destination files, if the ones proposed does not fit.
Change the ST selected if needed.

Apply a delay on the second file is possible, just check and enter wanted delay.
The second file will be created, and delayed from the delay entered.

*Append another srt file.
You can append a file to current one.
Click on Action>Append.
A dialog will open, asking for the srt file to open.
Just select it, and choose the delay to apply between the last current ST and the first ST that will be appended.

*Repair Sts.
You can repair some STs common problems.
=> remove accents, by clicking on Repair>Remove accents.
=> remove html tags, by clicking on Repair>Remove Html tags.
=> Fix Order issues, by clicking on Repair>Repair Order.
	It will re-order your STs using the start date. And it will fix their number.
=> Fix Time issues, by clicking on Repair>Repair Time.
	It will try to fix time overrides issues. by shifting start times and end time.
	
You can apply one or more Repair at once, by clicking on the Repair>Chain Repair menu.
	

3)COMMAND LINE UTILISATION
java -jar sears.jar [action  ActionParameters]
ACTIONS:
-delay:
  java -jar sears.jar delay d input_file [output_file]
  will delay the input's file subtitle using the given integer delay d.
  result will be write in the input_file, or in output_file, if output_file is given.
-resyn:
  java -jar sears.jar resyn src1 dest1 src2 dest2 input_file [output_file]
  will apply a resynchro to given input file.
  src and dest must be precised under format HH:MM:SS.MMMM
  result will be write in the input_file, or in output_file, if output_file is given.
-split:
  java -jar sears.jar split index input_file output_file1 output_file2
  will apply a split to given input file.
  It will cut the input file at subtitle which index is given.
  result will be write in the 2 output files output_file1 and output_file2.
-append:
  java -jar sears.jar appen d input_file1 input_file2 [output_file]
  will apply a append to given input file.
  It will append the subtitle of input_file2 with a delay of d.
  result will be write in the input_file, or in output_file, if output_file is given.

4)BUG REPORT, MORE HELP
Please go to Sears sourceforge page at:
http://sourceforge.net/projects/sears/

