
	       \/
		) SUBRIP 1.06  the DVD Subtitles speed ripper (  
	       /_______________________________________________\

               !  PLEASE TAKE A LOOK AT Credits.txt OR SubRip  !
               ! About Window  TO CONTACT _CURRENT_ DEVELOPERS !


*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*

	This is only a short doc about how to use SubRip...

	INSTALL: Just follow the instructions of installer.
	         (...and you were successful when you read this.)

*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*

	1 - WHAT IS SUBRIP?
	2 - LICENCE AGREEMENT
	3 - WARNING
	4 - OPERATING INSTRUCTIONS
	  I   - The SubTitles ripping
	  II  - OCR Process
	  III - Text correction and conversion
	  IV  - Split output text file
	  V   - Time correction
	  VI  - Font Styles
	5 - OUTPUT FORMATS NOTES
	6 - FAQ

*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*

		    ~~~~~~~ WHAT IS SUBRIP? ~~~~~~~

	- SubRip is a program which allows you to rip DVD subtitles with
	  their timing as a text file.
	- The goal is to allow you to translate the subtitles in
	  other languages, or just use them as they are.
	- You can also rip subtitles as BMP in the goal of putting them
	  on a SVCD (for viewing on a stand-alone DVD player) or on a
	  home made DVD.
	- SubRip use an OCR algorithm and I (Brain) spend a lot of time and
	  nights (and Dub's a bit too) coding it for you :) but I learned 
	  a lot of things with this experience.

*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*

		   ~~~~~~~ LICENCE AGREEMENT ~~~~~~~

	SubRip is FREEWARE (with sources released under GNU GPL). It means 
	it can be free distributed, copied, burned to CD etc., but only as 
	is in this installation package. It cannot be distributed as part 
	of any other software (without permission), no part of SubRip can 
	be included to other software.

	Also there is no responsibility for any damage of computer, it may 
	cause. You are running it on your own risc. There is no official 
	support, but we try to respond to all questions (except the stupid 
	ones) you send us - see DEVELOPERS CONTACT section in Credits.txt.

*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*

			~~~~~~~	WARNING ~~~~~~~

	- You only have the right to rip subtitles from vobs
	  or DVD that you have rights on, or for personal use
	  in country that allow private copy (like France).
	- Anyway in those contry CSS scrambling is illegal
	  because it lock the possibility of private copy !!!
	- Etc. etc...

*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*

		   ~~~~~~~ OPERATING INSTRUCTIONS ~~~~~~~

 I - The SubTitles ripping

	1 ) Rip the VOB and IFO files to your HDD using DVD Decrypter, DeCSS,
	    VobDec or any newest DVD ripper for recent DVDs that can't be
	    ripped with DeCSS. (Some old DVDs are not even scrambled at all
	    and can be used directly. Eg: The Fifth element & Stargate R2)

	2 ) Launch Subrip, click the "VOB" button or select "Open VOB(s)" in
	    the "File" menu. 

	3 ) Click on "Open IFO", then go to the directory you ripped the
	    files to and select and select the first IFO file.

	4 ) If nothing appears in the "Language stream" list, then try 
	    other IFO file.

	5 ) Select the language stream you want.

	6 ) Select the action you want.

	7 ) Reset the "Last time code" if it is not zero.
	    It's only used if you rip in more than session (if your
	    HDD is too small then start the following VOB with this time).

	8 ) Select the main film VOBs ( Generally from the first 1Gb VOB
	    to the last one )

	9 ) Click "Start"

 II - OCR Process

	1 ) A "Color selection" window will appear, verify that the
	    text is white on a black background, otherwise change the color.
	    In most cases you'll just have to click "OK" (Auto detection).
	    If it is NOT a text picture that appears ( menu or other ) then
	    click on "Skip pic" until the first subtitle of the DVD appears. 

	2 ) The OCR will ask you which character(s) it is displaying.
	    
	    You can try to click the "Search for an existing Matrix that match
	    for this Character" button, then to case:

	    - A Matrix containing the same font is found:
		This will avoid you to re-enter all the characters.
		Accept to open, complet it if some character are missed then
		resave the matrix file.

	    - Not any Matrix is found:
		Try on the next Character after typing current one, if still
		not found then do the following:

	    Enter the character(s) you see in the red box. This process will
	    not take-up too much time on most DVDs. Try to be as accurate as
	    possible, for this will result in a better text file. 
	     If you make an error typing the character, click the "Pause"
	    button, then go to "Characters Matrix" menu and click "Edit ..." 
	    Here you are able to correct your error, but you must restart the
	    OCR process at the first VOB to get all of the text recognized right. 

	3 ) Wait until the OCR process has finished. In case some rare characters
	    appear in the middle of the DVD the PC will beep to warn you. 

	4 ) After the OCR process has finished save the Characters Matrix File,
	    it can be used for other DVD that have same subtitles font -> Select 
	    "Save Character Matrix As" from the "Character Matrix" menu and put
	    it in the proposed directory ('ChMatrix' subdir) to enable Matrix
	    autodetection feature.

 III - Text correction and conversion

	1 ) Go to the Subtitles text window, click the spelling correction button
	    or select "Post OCR Spelling Correction" in the "Corrections" menu.
	    If "l" is confused with "I" (They both look the same for the OCR),
	    check the corresponding box and click "Correct This". This action
	    will correct most of the errors. 

	2 ) Click the save as button or select "Save as" from the "File" menu to
	    save the text in Subrip's own format (this will allow you to re-open
	    and edit it later). 

	3 ) Click the output format button or select  "Set Output Format" in the
	    "Output Format" menu and choose the format you want. 
	    Some external programs allow you to convert the SubRip file to other
	    standards ( Eg: MicroDVD player, DVD Maestro ... ).

 IV - Split output text file

	1) If you want to divide the original subtitle file into smaller parts
	   to put the movie on multiple CDs, you can use this function: 
		1- Click the split text file button or choose "Split output
		   file" from the "Output Format" menu.
		2- Check the "Split output File" box.
		3- Enter the Start and Stop time for the current file.
		4- Click "OK".
		5- Save file As "Name_xx.???" Where xx is the number of the CD
		   and ??? is the extension depending on the chosen format. 
		6- Repeat step 1 to 5 for each file. (Use the arrow-button to
		   set the last Stop time as Start time).

	   Important Remarks: 
		- The unselected part of the file will be kept until you open
		  another file or quit SubRip. It's recommended to first save
		  the full file in SRT format in case you need to modify it later.
		- The time codes will be corrected depending on the start time
		  (Start time will be deducted from all time codes in the file).

 V - Time Correction

	1) After a subtitle playback, you may want to change the start time
	   (time of the first subtitle) or the speed (global time).
	   !!! Never believe the time at DVD player displays !!! In most
	   cases their timing is wrong (eg: 8s/2h slower) especially on R1 DVDs.
	   Use a chronometer to verify it yourself!

	2) If there is really a time issue, launch SubRip and re-open the SRT
	   file. Go to time correction and do the necessary...

 VI - Font Styles

	You can (not must) use font styles in output subtitle file - bold, 
	italic and underlined (the last not in SSA). Currently are supported:

	SRT     : muxed in OGM file using Ogg Vorbis DS Subtitle mixer
	          - TAGS: <b>bold</b>, <i>italic</i>, <u>underline</u>
                  - VIEWING SUPPORT: (only as OGM!)
		      *any* DS capable player + DirectVobSub
		      *any* DS capable player + Ogg Vorbis Subtitle flt.

	MicroDVD: as Control Codes
	          MicroDVD specification sets the styles only for whole 
	          subtitle line, thus as workaround if current style(s) 
	          is not present for whole line, then instead of control 
	          code are quotation marks inserted.
	          - TAGS: {y:biu} or some less like {y:i}
                  - VIEWING SUPPORT:
		      *any* DS capable player + DirectVobSub
		      MicroDVD Player

	SSA     : - TAGS: {\i1}italicised{\i0}, {\b1}bold{\b0} or global
                  - VIEWING SUPPORT:
		      *any* DS capable player + DirectVobSub (excellent)

	The styles you can add in 'New Chartacter(s)' window by recognizing 
	process selecting the correspondent checkbox(es). If the checkbox 
	on the right is selected, then last typed style is remembered when 
	asking for new character. This may have disadvantage, if you forget 
	to reset style on font style changes. The style checkboxes you can 
	select either by mouse or using keystrokes Ctrl+B, Ctrl+I, Ctrl+U 
	like in MS Word. Styles could be also changed in 'View/Edit Character 
	Matrix' window.

*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*

		~~~~~~~	OUTPUT FORMATS NOTES ~~~~~~~

	Important notice: Set and config output format before processing 
	the DVD subtitles. It's important mainly when changing from BMP to 
	TXT output or vice-versa.

	Drop Frame (NTSC only): SubRip adds NON_DROP or DROP flag to header
	of output file. When checked then in addition some timecode 
	corrections are done (info from Brain: For NTSC Dropframe 
	timecodes, the following timecodes do not exist: Frame 0 and 1 of 
	each minute, except for 0, 10, 20, 30, 40 and 50 minutes.).
	Nothing more, so no FPS change or anything else!

	- DVD Maestro:
	  - after importing subtitles into DVD Maestro you must import 
	    palette file (.spf) too, in other case you'll get dark (black) 
	    subtitles.
	  - "Even values only" in Bitmap adjustment's Positioning for "Top 
	    Position (Y)" should be checked. In other case you'll get 
	    occasional line under the text.

*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*

			~~~~~~~	FAQ ~~~~~~~

	Q: There is unwanted space in the middle of a word. 
	A: Increase the Space width (Advanced OCR Setup).
	   The default value is 8, which is good for most movies, but is 
	   not universal. E.g. for japanese Metropolis (2001) movie was 13 
	   the right.

	Q: Some spaces are missing.
	A: Reduce the Space width (Advanced OCR Setup).
	   The default value is 8, which is good for most movies, but is not
	   universal. Reducing to 7 is enough in most cases.
	
	Q: The " character is badly recognized. SubRip asks for first half
	   and then for the second.
	A: It's not bug, it's feature :-). Type ' character 2 times (or "
	   character 2 times when you want) and after the whole subtitle 
	   recognition process is complete, select in "Subtitles" window: 
	   Corrections - Post OCR Spelling Correction and use the relevant
	   option.

	Q: Some characters are recognized as two (and then is asked for two),
	   but there is only one.
	A: Yes, there are some problematic characters, as I know: sometime 
	   except the one above also % note sign
	   and ; or : or ! in italic style.
	   When this case appear, I type the correct character on first ask 
	   and on second ask I type the same with some tag (<todo> etc.) for 
	   later correction in some word processor. You can also leave the text
	   for second ask blank, when you are sure that nothing wrong occurs...

	Q: SubRip asks sometimes for more than one character, e.g. for rv.
	   Why do not split it?
	A: Just type these 2 (or more) characters. There is no other way, 
	   because there is not a single one space between these characters.

	Q: There is no subtitle picture or only menu pictures.
	A: Try next VOB(s) or another language.

	Q: The OCR is slow and Characters Matrix is very large (>512 chars). 
	A: It's better to use a different Characters Matrix File for each Font style.
	   The same file should be used on more than one DVD if the font match.
	   Try the "Search for an existing Matrix that match for this Character"
	   button and if not found then you have to create a new Matrix.
	
	Q:  Subpictures are scrambled.
	A1: Have you ripped the DVD to your HDD using a CSS descrambler?
	A2: If the VOB is ripped correctly, send me an e-mail and try to skip the subtitle. 
	    (I know that Abyss R1 does that because of seamless branching)

	Q: The time restart from 0 in the middle of the DVD (about 1 hour).
	A: Try to activate the corresponding option in the "What to do?" Window.

	Q: I don't want the styles (e.g. <i>text</i>), that's the reason why I 
	   come back to use the 0.97b version.
	A: Using styles is OPTIONAL. When you not select some style, then is not 
	   used. I'm not kidding :-).

	Q: I wanna rip certain subtitle stream, SubRip shows them, but 
	   scans through the file without finding any subtitle (or rip 
	   another stream). Other streams are ripped fine, so why?
	A: SubRip shows and rip subtitle streams according to IFO (IDX) you 
	   provide. (BTW that's why are shown all DVD subtitle streams 
	   including the ones that you don't have ripped.) When software 
	   you use (ex)change stream positions in the VOB (rip or VOB 
	   editing soft) without updating IFO or the same conversely (IFO 
	   editing soft), then arise this problem.
	   To solve it, rip the whole DVD without any changes or try 
	   another rip utility. You can eventually try to find your 
	   subtitles under some of unrecognized streams (32 totally).
	   Update: Since v1.033 you can use "Verify" button ("What to do?" 
	   dialog) to scan VOBs for really available subtitle streams.

	Q: What are those FORCED subtitles?
	A: Forced subtitles are used often in war movies where more 
	   languages are spoken. Or as translation of headings (newspapers, 
	   stores, buildings, marks, ...) when dubbing enabled.
	   DVD Player shows subtitles with FORCED flag even if subtitles 
	   are off according to selected audio stream.

	Q: Some of my (older) DVDs doesn't have standard subtitle streams 
	   but only *Closed Captions* coded inside the MPEG-2 video stream.
	A: SubRip cannot process these subtitles, but there's a tool called 
	   CCParser (Doom9's download page). Inside the archive you'll find 
	   instructions how to extract the closed captions (line21) to raw 
	   binary format. Then use CCParser to convert them into SubRip 
	   format.

	Q: I've found a bug or have a suggestion and don't know who to contact.
	A: Follow DEVELOPERS CONTACT section in Credits.txt file and read 
	   the provided instructions.

*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
 

       _________________________________________________________
      /								\
     /		       submagic@netcourrier.com		         \
    /_____________________________________________________________\
   (_			   				          _)
    _) ()			BRAIN			      () (_
   (_______________________________________________________________)
    \							          /
     \		       http://www.subrip.fr.st/		         /
      \_________________________________________________________/
