1. Create XSUB or Idx/Sub
2. Configuration 1
3. Configuration 2

1. Create XSUB or Idx/Sub

1. File Name(s). Input. Is entered the name of the video file. Can be a group of 1 or more files or a group of 1 or more folders or a mix of these. There are various ways to fill this box. By typing, by the button (...) (2) which displays a File Open dialog, by drag&drop of selected files or folders in the icon of the program or its shortcut, or directly to the edit box when the program runs. You can also activate "Right Click option" through "Configuration 2" and just right click over selected files or folders and be able to fill this box automatically.

2. Displays a Open File dialog and permits the user to select one or more files to enter at 1.

3. Output Folder. The output of the program goes to this directory. If this option left empty then the output goes in the same place as the original file. You can type the full path of the folder or use button 4 to display a select folder dialog.

4. Displays a dialog to select a folder to fill the output directory at 3.

5. When 1 is filled with files to be processed, press "Start".

6. When an operation is in progress you can stop it at any time pressing "Stop".

7. Exit. Exits the program.

2. Configuration 1

This tab permits the configuration of basic parameters of the generated subtitles, about colors, fonts, fonts size and position, character set and language. It contains another 8 tabs (SUB 1-8) that represent srt to be loaded and processed and one tab (idx/sub) for a pair of idx/sub files to be loaded and converted in XSUB.

The tabs SUB 1-8 load srt and produce subtitles in various configurations for both types, XSUB (incorporated only in avi) and idx/sub (external files) for any kind of video file. Look at 1 below. The idx/sub tab configures one idx/sub file that would be converted to XSUB and incorporated in the avi.

SUB 1-8 tabs

1. XSUB or Idx/Sub. The program can generate two kind of bitmapped subtitles. XSUB that incorporates as an additional stream in avi files, and idx/sub. The second subtitle type is not incorporated in the video file, is a combo of two external files with .idx and .sub extension. Because the generation of this kind of subtitles doesn't not affect or need in any way the video file and only the srt then it can accompany any kind of video file and not only avi as in the case of XSUB. Of course your hardware player has to support the combination of the specific video file and idx/sub. Choose the subtitle type that your player supports better.

2. Rearrange Subtitle text. This option controls a function of the program which processes the text of every subtitle and rearranges to fit in a specific screen width to avoid some text to go out of your screen. There are three selection.

When Very Long: Activates this function only when the text is too long to fit in the screen.

Always: To have a more uniform text for all subtitles regardless if they fit or not.

Never: Subtitles appear as the srt creator made them. Note that even the rearrange function is deactivated the program will use a smaller font if a subtitle appears not fitting in the screen.

The operation of this function is affected through option "Overscan" at 19.

3. Character Set. As the most srt are in ANSI format (not Unicode) the character set used has to be entered there. The selection DEFAULT uses the information entered in your Windows system at "Control Panel/Regional and Language Options/Advanced/default character set for non-Unicode text". ANSI is for western languages Latin alphabets. Please note that only ANSI srt files are supported, not UNICODE or UTF8.

4. Language Code. This is informational and marks the subtitle with the code of the language selected. The language information is displayed in various players when selecting subtitles.

5. Font. Font name. You can type it or select it from a list pressing button at 6.

6. Select a font family from a list of available fonts.

7. Font Size. Select the font size you prefer.

8. Width. Controls the width of the text as a percentage of its default for the specific size (Height) entered at 7.

9. Bold. The generated subtitle text is in bold.

10. Outline size. In pixels. Defines the thickness of the outline used.

11. Color. Chose the color of subtitles. You can choose color for both, text body and its outline.

12. Align. In case of multiline subtitles. This option defines its alignment (justification). Left, Center or Right.

13. SRT Extension. This, very important, option defines the file name of the srt to be loaded and processed according to the configuration found on every tab 1-8. The name of the srt to be loaded is defined in a specific way: [video file name]+[SRT Extension]+[.srt]. So having all the rest of file name parts constant you control the "SRT extension" part through this option. If left empty the video file name and srt file name will be exactly the same - except extension. See more at "Multiple subtitles from srt".

14. Opaque box. An opaque box surrounds the subtitle in the color of the outline. This is used mainly to cover up subtitles burned in the video picture already and so make more readable and distinguished your subtitles.

15. Preview. You can see how your subtitles appear when all selections (at tabs 1-8) have been applied. There is a sample text but you can load any srt to see the result with real subtitles. You can see all effects applied to subtitle except positioning on screen which depends on player's firmware and is not possible to be depicted by the program:

16. Add Subtitles. Adds the subtitles. Normal operation

17. No Subtitles. No subtitles generated. In this case already incorporated XSUB subtitles in avi will be removed. Option "unpack packed bitstream" will apply if checked.

18. Add Test Subtitles. Adds test subtitles that start from the top of the screen and go to the bottom.

19. Subtitle bitmap. The generated subtitles are bitmaps and through this option their resolution is defined. There are three option:

• 720 X 576 (PAL)

• 720 X 480 (NTSC)

• Custom

When "Custom" is selected then you are able, manually, to enter Width and Height of the bitmap.

Full Screen. When this option is checked then a full bitmap in the specified resolution will be created for every subtitle. If not checked then the subtitle will have the resolution necessary to contain its text but will be marked for the resolution defined. Generally leave this option unchecked. Some players need this checked to display subtitles or have them in a constant VP/CP (see 20 below) for all videos. Experiment to see what fits best for your player in case of problems.

Overscan. In case of analog connections from your player to your TV there is a part of the screen, left and right that is cut off. This is, nominally, about a 13% of the total width. This option instructs "Rearrange Text" option (2) to think that the available width is 13% less that the one selected for the subtitle bitmap. In case an HDMI interface (that is, digital) is used this option can be unchecked so subtitles can utilize the whole screen width.

20. Subtitle position. There are two values that control the position of subtitles in your TV. VP (Vertical Position) and CP (Center Point - or Horizontal Position).

VP has the value of zero (0) and the top of your TV screen and as the subtitles go down, increases. Points to the bottom of every subtitle so the top of the subtitle is calculated through the following formula: VP-Subtitle Height.

CP is a value that determines the center of your TV screen so the subtitles can be positioned in its center.

Is very important to understand that these values are not depended on your TV but in the way the firmware of your player interprets them. So there is no any standard concerning these values. Every player needs its own values to display subtitles in the wished position on your TV. Most of the time you have to experiment a bit to find the correct values. This is done once for every player. It is true that some players cannot be configured with one set of values and they need different values depending on the video resolution. The solution in this case is for the user to find out this relation and select the correct values for any given video resolution by hand. Another solution is to incorporate more than once the same srt, in various VP/CP (usually only VP varies) configurations so at playback time can choose the correct subtitle for the given video. This ability is controlled through "SRT extension" (13) option because any of the SUB 1-8 tabs having the same value in this field load the same srt. So use this ability to have one srt producing subtitles in various VP/CP values, selectable at playback.

idx/sub tab

This tab configures idx/sub subtitles you wish to convert in XSUB exclusively for avi video files.

The idx/sub to XSUB conversion tab includes the same "Subtitle Bitmap" and "Subtitle position" options, as in the case of SUB 1-8 tabs. Because idx/sub contain subtitles already in bitmap format all other options found at SUB 1-8, with the purpose to construct the text content of the bitmaps, are not needed. Instead there is a new set of options under the "Choosing Subtitles". One idx/sub combo can contain subtitles in many languages so the user has to be able to select which of them to include in the conversion process.

All. Subtitles in all languages will be included.

Ask User. A dialog asks the user which of them to choose.

These Language codes only. When this is selected then, in the edit box below it, the user has to enter the language codes to be selected automatically every time an idx/sub is converted to XSUB. The language codes have to be separated by comas, as in the picture.

NOTE: If the Idx/Sub subtitles are not satisfying to you in readability, size and colors, you can use IdxSub2Srt application to convert in srt format and then in XSUB through AVIAddxSubs.

3. Configuration 2

Some additional configuration options, of a general scope, can be found here.

1. Unpack packed bitstream. Some players (like my PHILIPS DVP5980) do not fully support "packed bitstream". This causes some video encoded this way to appear with jerky move, like some frames are dropped, etc. This is a nice way to catch a headache. If this option is checked (default) the frames become unpacked automatically and all "packed" AVIs have a much smoother playback. Unpacking packed bitstream has nothing to do with video compression. The "unpacked" AVI actually can be slightly smaller.

2. Use .avi for output file(s) if possible. By default the output file is named with extension divx. If this is checked and has been defined an output directory different from the one of the source file, then the generated file is named with extension avi. This cannot work, of course, when input and output directory are the same because we cannot write the new over the original avi.

3. Delete original avi: If this option is checked then after the successful generation of the new subtitled file, the original (or source) will be deleted.

4. Move srt to output directory: When is checked (and the avi is copied too) the srt is moved in the output directory. Please note that the srt is not needed to view the subtitles in the player. This option is useful in cases the output directory is used also for archiving purposes. To avoid confusion do not burn the srt together with the avi in the DVD will use to play the video in the player.

5. Do not copy avi when no XSUB: Checking this option and configuring the program only for idx/sub generation the original avi will not be copied in the output directory. Please note that except of cases of a simple copy of the file this operation applies the "Unpack packed bitstream" option that makes some players to have a smoother playback.

6. Do not convert idx/sub in XSUB: You need to check this option in case you generate only idx/sub subtitles and you don't want idx/sub to be converted in XSUB and incorporated in the avi. This way you are avoiding the case when the program will take its idx/sub output as input when you repeat the subtitle operation. This can happen when the input and output directories are the same.

7. YUV values at Idx/Sub color palette: If this is checked then for idx/sub color palette YUV values are generated else RGB values.

8. Start at once: When files or folders are dropped to programs icon or shortcut, or through right click on them, then if this option is checked the processing will start immediately without having the user first to press "Create Subtitled DivX file".

9. Mark DivX as: You can mark generated divx files as DIVX, XVID or DX50. Some players need a specific mark to show the subtitles. This option affects original avi with the above marks that represent compatible encodings. For example DIV3 avi will not be affected by this option. Selection NONE leaves the mark of the original avi.

10. Chapter every ... minutes. When a value above zero is entered there then this defines a time interval at which a chapter will be generated. If the value is zero then no chapters are generated. In case of adding chapters then a small avi supplied in the zip is incorporated in the avi. This small avi ("menu.avi") displays the message "Loading... Please Wait...".  The user can change that to display another message or picture(s) of his/her preference. See more at Changing the introductory avi. For this feature to work the hardware player has to support officially or unofficially DivX Ultra.

11. Right Click Context Menu Option. Provides the ability to select an avi or a group of avi or a group of folders (or a mix) with a right click in the selection:

This is a fast way to start the program. Note that if "Start at once" (8) is checked then the process starts immediately without the need to press button "Start" (First tab - 1) first.

Please note that when this option is activated AVIAddXSub.dll file of AVIAddXSubs installation is connected with Windows shell. So if you try to delete this file the OS will refuse because it uses it. In this case, to delete this dll (for example to upgrade to newer version), first disable this option, make a log off/log on (or reboot) and then you will be able to delete it.

12. Subtitle Time (in milliseconds). Under this title there are two options:

• Time Shift by ... a number of milliseconds. Using a negative number subtitles will appear the specified milliseconds sooner. With positive numbers later.
• Increase Duration by ... a number of milliseconds. This is useful in cases that subs go away very fast or the synchronizations is "suspected" not that good. Of course the duration extension is limited by the start of the next subtitle.

Multiple Subtitles from srt

In configuration page you can configure up to 8 srt subtitle files. There are 8 tabs, SUB1 through SUB8, with a number of configuration options. For every tab corresponds a srt file that is searched through a specific naming convention. This naming convention is controlled through a literal at option "SRT extension" found in every such tab. The corresponding srt file name is composed from the avi file name and the literal defined in the aforementioned option, that is [AVI name]+[SRT extension]+[.srt]. For example, to an avi lost0204.avi and a "SRT extension" "-en" corresponds a srt "lost0204-en.srt". If "SRT Extension"  is empty the srt file has exactly the name of the avi: lost0204.srt.

In case you wish to incorporate the same srt more than once in an avi, using different configurations in every incorporation, enter the same literal in "SRT extension" option for all those tabs (SUB 1-8) that represent those configurations.

Examples:

For a file lost0303.avi, a tab (SUB 1-8) with "SRT extension":

• empty string loads the srt "lost0303.srt"
• "-en" loads the srt "lost0303-en.srt"
• "-pt" loads the srt "lost0303-pt.srt"
• "-For My flat TV" loads the srt "lost0303-For My flat TV.srt"
• ".fr" loads the srt "loast0303.fr.srt"

Starting and ending AVIAddXSubs without user intervention.

Normally to start the processing the user has to press "Start". But if the program starts through a drag&drop or through right click menu option and if the configuration page option "Start at once" is checked, then this step is bypassed and the processing starts immediately.

Also there is a capability so AViAddXSubs can stop its execution after finishing processing. This is intended to advanced users that wish to use the program in batch processing jobs that do various things and a XSUB subtitle incorporation in addition. This capability can be accessed only through AVIAddXSubs configuration file (aviaddxsubs.txt) and through the parameter ENDATONCE. Its default value is 0. Just put an 1 there.

About Idx/Sub subtitle files (in case of conversion in XSUB format)

Any such file pair can contain subtitles for more than one languages. In case of more than one language a dialog will appear so the user is able to choose which of them to include. Up to 8 languages can be selected and included.

Also in case the subtitle colors are not satisfactory the user is able to intervene in the idx file with any text editor, like Windows notepad, and get better results. First check the text entry Custom Colors. This entry provides a palette of 4 colors that can be used in subtitle bitmaps. This entry appears as in the following example:

custom colors: ON, tridx: 0001, colors: 000000, 808080, FFFFFF, 0000FF

Check if marked as ON or OFF. If it is OFF make it ON and check again in case you get better results. If not you can change any of these colors as follows: In the same entry there is a section with the name tridx. This defines which of the palette colors are used as transparent. Its value is four digits of 0 or 1. If you see 1, then in the corresponding palette position there is a transparent color. Then you point your attention to the rest of palette colors. To get letters with white body and black outline, use the (RGB in hex format) color FFFFFF (white) and 00000 (black). Put these values in the various none transparent positions of the palette (all except the last in the example above), every time save the idx file, run AVIAddXSubs and see if the result is now satisfactory.

Changing the introductory avi (XSUB)

When user chooses to add chapters in the generated avi then a small supplied avi ("menu.avi") is incorporated in the final file. This avi displays a message ("Loading... Please Wait...") briefly at video initialization. User is able to replace this avi with another that display what he/she prefers. To do so just use an imaging software to create an image (.jpg) with 720X576 resolution. Then use VirtualDub to make an avi based in this image (or many images if you prefer). Load the image(s) with VirtuaDub. Then select any Frame Rate (I choosed 1) and choose for compression XVid. These options are under the menu "Video" of VirtualDub. Then you can save the new avi under the name "menu.avi". Finally replace the supplied avi with this one and start incorporating subtitles as usual using any interval for the generated chapters.

SUBRenamer utility

This utility is used to rename easily an avi file and its associated srt. The easiest way to use it is to create a shortcut of the program in your desktop. Then select an avi and all its associated srt and drag&drop them to program's shortcut. When the program runs resembles in a way the list of SUB 1-8 + idx/sub tabs in AVIAddXSubs itself. The avi will appear under an edit box named "AVI File" and all srt (or idx) in the list at the bottom. The list has always 9 lines. The lines 1-8 represent SUB 1-8 tabs of AVIAddXSubs and the 9 the idx/sub tab. Every file will go in an appropriate position. You can use "UP" and "Down" buttons to rearrange the list so every srt file is listed in the SUB position you prefer.

In the list there are four columns. The first is the SUB number and the second is the current srt/idx file name. The third (ext) and four (lang) display information read from AVIAddXSubs configuration file. They display the literal found in "SRT extension" and the language for all tabs 1-8.

Under the edit box "New common name for avi and idx/sub" will appear automatically the name of the AVI without extension. For example if the avi was "lost0209.avi" there will appear "lost0209". You can accept or modify this name. Under this name all files (avi, srt, idx, sub) will be renamed if you press the button "Rename".