View source for Documentation:Subtitles

{{RightMenu|documentation play howto toc}}
VLC supports many kinds of subtitles.

==Media with included subtitles==

Many types of media can have embedded subtitles. VLC can read subtitles for the following media formats:
*DVD
*SVCD
*OGM files
*Matroska (MKV) files

Subtitles are disabled by default in VLC media player. To enable them, go to the ''Video'' menu, and to ''Subtitles track''. All available subtitles tracks will be listed. Select one to get the subtitles. Depending on the media, a description (language, for example) might be available for the track.

VLC under Linux:

[[File:VLCSubs.png]]

VLC under OSX:

http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-osx-select-sub.jpg


DVD and SVCD subtitles are merely images, so you won't be able to change anything for them. OGM and Matroska subtitles are rendered text, so you will be able to change several options.

Text rendering options can be changed in the Preferences. In the ''Modules'' section, ''text renderer'' subsection, open the ''freetype'' page. You can then set the font and its size. For the font, you have to select a font file. Under Windows, they can be found in ''C:\Windows\Fonts''. Under MacOS X, they are in ''/System/Library/Fonts''. Size can be set either relatively or as a number of pixels.

You need to restart your stream for the font modifications to take effect.

==Subtitles files==

While modern file formats like Matroska or OGM can handle subtitles directly, older formats like AVI can't. Therefore, a number of subtitles files formats have been created. You need two files: the
video file and the subtitles files that only contains the text of the subtitles and timestamps.

VLC can handle these types of subtitles files:
*MicroDVD
*SubRIP
*SubViewer
*SSA
*Sami
*Vobsub (this one is quite special: it is not made from text but from images, which means that you can't change the fonts)

To open a subtitles file, use the Advanced Open dialog box (Menu File, Open file). Select your file by clicking on the ''Browse'' button. Then, check the ''Subtitle options'' checkbox and click on the Settings button.


[[File:VLCadvanceopen.png]]


You can then select the subtitles file by clicking the ''Browse'' button. You can also set a few options like character encoding, alignment and size. 

Note: For Vobsub subtitles, you need to select the '''.idx''' file, not the '''.sub''' file.
Encoding, alignment and size won't have any effect for Vobsub subtitles.

Font can be changed as explained in the previous section.