Difference between revisions of "Documentation:Subtitles"

From VideoLAN Wiki
Jump to navigation Jump to search
m (Change HTML comment)
 
(23 intermediate revisions by 8 users not shown)
Line 1: Line 1:
 +
{{Image requested}}<!-- All images shown are out of date. The subtitles menu is no longer a sub-menu of the video menu, and Windows and Linux both use the same interface (Qt4) -->
 +
{{RightMenu|Documentation TOC}}
 
VLC supports many kinds of subtitles.
 
VLC supports many kinds of subtitles.
  
 
==Media with included subtitles==
 
==Media with included subtitles==
  
Many types of media can have embedded subtitles. VLC can read subtitles for the following media:
+
Many types of media can have embedded subtitles. VLC can read subtitles for the following media formats:
 
*DVD
 
*DVD
 
*SVCD
 
*SVCD
Line 9: Line 11:
 
*Matroska (MKV) files
 
*Matroska (MKV) files
  
Subtitles are disabled by default. 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.
+
Subtitles are enabled by default in VLC media player. To disable them, go to the ''Video'' menu, and to ''Subtitles track''. All available subtitles tracks will be listed. Select "Disable" to turn off the subtitles. Depending on the media, a description (language, for example) might be available for the track.
  
http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-wx-select-sub.jpg Select a subtitles track under Windows or Linux'''- needs verifying for 0.9'''
+
To disable subtitles by default, select "Preferences", then "Show All".  Select "Input/Codecs".  On the "Subtitle Track ID" selection window, change the value to "-1". (NOTE: Changing the value in the "Subtitle Track" menu will not disable the subtitle file.) In the case of multiple subtitle tracks, a value of "0" will enable subtitle track 1, a value of "1" will enable subtitle track 2, and so on.
 +
 
 +
 
 +
VLC under Linux:
 +
 
 +
[[File:VLCSubs.png]]
 +
 
 +
VLC under OSX:
 +
 
 +
https://images.videolan.org/images/documentation/play-howto/intf-osx-select-sub.jpg
 +
 
 +
VLC under Windows:
 +
 
 +
[[File:Basic_subtitles_selection.png]]
  
http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-osx-select-sub.jpg Select a subtitles track under MacOS X'''- needs verifying for 0.9'''
 
  
 
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.
 
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.
+
Text rendering options can be changed in the ''Preferences'' in the ''Tools'' tab. To adjust the font preference check the ''All'' bullet in the ''Show Settings'' box, and then click ''Subtitles/OSD''. You can then set the font and its size under ''Text Renderer''. For the font, you have to select a font file. In Windows, they can be found in ''C:\Windows\Fonts''. Under MacOS X, they are in ''/System/Library/Fonts''. Sizes can be set either relatively or as a number of pixels.
 +
 
 +
[[File:Basic_subtitles_prefs.png]]
 +
 
 +
Subtitle text rendering preferences under Windows, VLC 1.1.5
  
 
You need to restart your stream for the font modifications to take effect.
 
You need to restart your stream for the font modifications to take effect.
Line 24: Line 42:
  
 
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
 
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.
+
video file and the subtitles file that only contains the text of the subtitles and timestamps.
  
 
VLC can handle these types of subtitles files:
 
VLC can handle these types of subtitles files:
Line 34: Line 52:
 
*Vobsub (this one is quite special: it is not made from text but from images, which means that you can't change the fonts)
 
*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.
+
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:Subtitles.PNG]]
 +
 
  
http://www.videolan.org/doc/play-howto/en/images/play-howto/intf-wx-sub-file.jpg Select a subtitles file under Windows or Linux'''- needs verifying for 0.9'''
+
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.  
  
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. The delay option allows you to delay the subtitles against the video if they are not in sync. If they are not at the same speed, you might also want to adjust the subtitles framerate.
+
An alternative is loading subtitles from the ''Subtitles Track'' menu item under the ''Video'' tab.
  
 
Note: For Vobsub subtitles, you need to select the '''.idx''' file, not the '''.sub''' file.
 
Note: For Vobsub subtitles, you need to select the '''.idx''' file, not the '''.sub''' file.
Line 44: Line 65:
  
 
Font can be changed as explained in the previous section.
 
Font can be changed as explained in the previous section.
 +
 +
{{Documentation}}
 +
 +
[[Category:Subtitles|*]]

Latest revision as of 04:15, 12 February 2019

Help VideoLAN by adding an image to this page!
Create an account and then upload.
VLC User Guide

Quick Start Guide
Installing VLC
History
Usage
Interface
Open Media
Audio
Video
Playback
Playlist
Subtitles
Video and Audio Filters
Snapshots
Hotkeys
Uninstalling VLC
Troubleshooting
Advanced usage
Using VLC inside a webpage
Command line
Alternative Interfaces
Misc

Appendix
Building Pages for the HTTP Interface
Format String
Building Lua Playlist Scripts
View this alone

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 enabled by default in VLC media player. To disable them, go to the Video menu, and to Subtitles track. All available subtitles tracks will be listed. Select "Disable" to turn off the subtitles. Depending on the media, a description (language, for example) might be available for the track.

To disable subtitles by default, select "Preferences", then "Show All". Select "Input/Codecs". On the "Subtitle Track ID" selection window, change the value to "-1". (NOTE: Changing the value in the "Subtitle Track" menu will not disable the subtitle file.) In the case of multiple subtitle tracks, a value of "0" will enable subtitle track 1, a value of "1" will enable subtitle track 2, and so on.


VLC under Linux:

VLCSubs.png

VLC under OSX:

intf-osx-select-sub.jpg

VLC under Windows:

Basic subtitles selection.png


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 Tools tab. To adjust the font preference check the All bullet in the Show Settings box, and then click Subtitles/OSD. You can then set the font and its size under Text Renderer. For the font, you have to select a font file. In Windows, they can be found in C:\Windows\Fonts. Under MacOS X, they are in /System/Library/Fonts. Sizes can be set either relatively or as a number of pixels.

Basic subtitles prefs.png

Subtitle text rendering preferences under Windows, VLC 1.1.5

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 file 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.

Subtitles.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.

An alternative is loading subtitles from the Subtitles Track menu item under the Video tab.

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.

This page is part of official VLC media player Documentation (User GuideStreaming HowToHacker GuideModules)
Please read the Documentation Editing Guidelines before you edit the documentation
Permission is granted to copy, distribute and/or modify this document 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.