Table of contents User interface
Opening subtitle files
Saving subtitles
Loading video files
Subtitle editing
Subtitle synchronization
Codec instalation
User Interface Subs Doctor consists of a main window and a preview window.
Main window
The main window displays a list of all the subtitles with their respective show and hiding times. In addition it provides controls for video playback, subtitle timing and synchronization.
Preview window
The preview window displays the video as well as the subtitles. On the top of the window you have the current movie time and at the bottom you have volume and standard play controls.
Table of contents
Opening subtitle files SubsDoctor supports SubRip (.srt), MicroDVD (.sub) and SubViewer (.sub) subtitles formats. You can open a subtitle file in one of three ways:
  1. From Finder - This is the simplest way to open a subtitle file, you just need to locate the file you want to open on Finder and double click it.
  2. Drag and drop - Locate the file you want to open on Finder and drag it to the main window.
  3. From the application menu - Select "File->Open..." menu (⌘ + O). A open dialog will pop-up where you can select the file you wish to open. This way you can also select the desired encoding to use. Notice that only the supported encodings for the selected file are listed. A preview of the file will be available for files located on your Downloads and Movies folders.

Be aware that, using the first two methods you cannot chose the text encoding so Subs Doctor tries to guess it for you, sometimes this guess can be wrong. You will notice that if you see strange or missing characters. In this case you should use the third method.

When opening a subtitle file, any video file that is opened on the preview window will be closed.

Note: When you open a subtitle file you will be prompted to open a video as well. If you wish you may skip this step and open the video at a later time.


Table of contents
Saving subtitles You can save a subtitle file in one of two ways:
  1. Save from the application menu. - Select "File->Save" menu. This saves the file with the current format and encoding. You can also use the shortcut ⌘ + S.
  2. Save as... from the application menu. - Select "File->Save as..." menu. A save dialog will pop-up where you can select the desired file name and format, as well as the desired text encoding. Notice that only the supported encodings for the current subtitle are listed.

For saving subtitles the recomended text encoding is UTF-8 since it can encode all unicode characters in a very space efficient way. Besides, it is supported by most video players and is self identifieable, that means that most video players can automatically recognize it.


Table of contents
Loading video files There are two ways to load a video file on SubsDoctor:
  1. From the application menu. - Select "File->Open video file..." menu. This shows a open dialog where you can select the file. When there is no video loaded you can also load a a video by pressing the "Open video file..." on the preview window.
  2. Drag and drop - Just locate the file you want to load on Finder and then drag it to the preview window.

Be aware that some video files may use audio and video codecs that are not installed by default on your system.

If you have audio or video problems may want to install Perian, current version is 1.2.3 and it has been reported some problems with AC3 (A52) audio codec on OS X Mountain Lion. If you are not using Mountain Lion you don't have to worry about this, but if you are using it you may want to try one of the several fixes available by searching on the net. Be aware that some fixes may not work on certain systems.


Table of contents
Subtitle editing When creating a new subtitle file, you just have to type the subtitle text on the botton right text box of the main window, this will automaticaly create your first subtitle. The first subtitle default show time is 00:00:00.000 and the default subtitle duration is 1 second.

During the subtitle text entry you may press [⏎] key to start typing on a new line.

You can use the [⇥] key to select the next subtitle, or [⇧ + ⇥] to select the previous subtitle.

If the selected subtitle is the last one, selecting the next subtitle will create a new subtitle with the show time equal to the hide time of the last subtitle.

In order to set the start time for the selected subtitle you should position the video on the begining of the speech then press the "Set start time" button

In order to set the end time for the selected subtitle you should position the video on the end of the speech then press the "Set end time" button


Table of contents
Subtitle synchronization Sometimes the subtitles may not match with the audio.

Subs Doctor can fix this easily by following these steps:

  1. Load the subtitle.
  2. Load the video.
  3. Disable the "Auto select" button.
  4. Play the video until you hear a speech that you can easily identify, preferable near the start of the video (you can use the search feature to help finding the matching subtitle on the list).
  5. Press the sync point button 1.
  6. Play the video until you hear another speech that you can easily identify, preferable near the end of the video (you can use the search feature to help finding the matching subtitle on the list).
  7. Press the sync point button 2.
  8. If the selected sync points are valid a dialog will pop up where you should confirm the sync point selection.

You can now play the movie just to make sure the sync operation completed successfully. If everything is alright you can now save the subtitle.


Table of contents
Codec installation If you cannot get audio or video when playing files most likely you don't have the required codecs installed.

We recommend you to use Perian since it can handle most audio and video codecs. However, since Mountain Lion version of OS X, AC3 (A52) audio codec is no longer working on some systems. You can find on the Internet lots of suggested fixes for this problem, but since we couldn't find one that effectively worked on all systems we choose not to sugest it here since it may not work on your particular system.

You can find Perian oficial website here. Unfortunately, Perian is no longer a work in progress, however it is announced one final version that may solve the audio codec issue. Alternatively, you can use tool that recodes the audio track with another codec.

The following video shows how to install Perian.


Table of contents