Getting subtitles on VLC using VLSub?

If you don’t have subtitles for watching a movie ready with you, there’s an easy way to download them. It’s called VLSub, and it is an extension of the VLC Media Player for downloading the subtitles available on, right from the video player itself. Getting subtitles for VLC is a very easy task. Read on…

This article have been updated on 26.2.2017 because older version of VLSub stopped working. You have to update extension to the latest version found on VLSub github.

VLSub does not work on VLC 2.1.x, so make sure you are using VLC 2.0.x or 2.2.x.

Downloading and installing the VLSub VLC subtitles plugin:

1. Go to (or anywhere on the internet) and download the VLSub VLC subtitles plugin.

Screenshot 2015-05-17 22.55.32


2. Check whether you have the “extensions” directory in the following location:

  • Windows (all users): %ProgramFiles%\VideoLAN\VLC\lua\extensions\
  • Windows (current user): %APPDATA%\vlc\lua\extensions\
  • Linux (all users): /usr/lib/vlc/lua/extensions/
  • Linux (current user): ~/.local/share/vlc/lua/extensions/
  • Mac OS X (all users): /Applications/
  • Mac OS X (current user): /Users/%your_name%/Library/Application Support/org.videolan.vlc/lua/extensions/

If you don’t see this directory, create a new folder named “extensions” in the above said location.
Screenshot 2015-05-17 23.36.03


3. Open the downloaded zip file and extract the file named “vlsub.lua” into the “extensions” directory (If there is any error in directly doing this, extract the files in a different location and copy paste the “vlsub.lua” file into the “extensions” directory).

Screenshot 2015-05-17 22.57.00
Using VLSub and getting the subtitles:

1. Play the video file using VLC Media Player. It’s time to get the subtitles for VLC! Click View -> VLSub or VLC -> Extension -> VLSub in the case of Mac OS X.
Screenshot 2015-05-17 23.37.19

2. Now, search by hash/name for subtitles and a list of VLC subtitles available on, appears for your video.
Screenshot 2015-05-17 23.41.59

3. Choose the subtitle file that you need, and click “Download selection”. Voila! Subtitles appear on you video.
Screenshot 2015-05-17 23.42.40

Now, you can enjoy any movie with VLC subtitles. You can click on the “Show config” button and search for subtitles in various languages. You can also choose what to do with the subtitles, i.e. Load and save or Manual download.

Go ahead and start watching your favorite videos with subtitles!

VLSub – subtitles extension for VLC is one of the many programs which are using OpenSubtitles API. Enjoy this free subtitles service and if you like it, consider making a small donation.

Start the discussion at

Show archived comments
  1. worked for a little while with vlc 2.2.2. Does not work with 2.2.3 and when I went back to 222, the sub did not work. There is also a problem with the downloaded files: they all window files: exec, md. Will not work on a mac.

  2. Estava funcionando no windows 10 com o VLC 2.2.4 com o vl sub 0.10.0 faz dois dias que na hora do downloading trava o VLsub…. alguem tem a solução?


( 7 Responses )

Read more

The Most Commonly Used Movie Clichés in OpenSubtitle Files

We’re excited to share fascinating research conducted by Stephen Follows, who used our extensive subtitle database to uncover the most commonly used clichés in movie dialogue.

By analysing over 72,000 films released from 1940 to 2023, Stephen has provided intriguing insights into how often and how these clichés have evolved in cinema.