VLSub is a VLC extension to search and download subtitles from opensubtitles.org using the hash of the video currently playing or its title.

This tutorial is going to show you how to install this plugin for VLC in Ubuntu 13.04 Raring, Ubuntu 13.10 Saucy, and their derivatives such as Linux Mint.

VLSub plugin for VLC

To get started installing this extension, press Ctrl+Alt+T key combination on your keyboard to open terminal. When it opens, run below command to download the plugin from github:

wget https://github.com/exebetche/vlsub/archive/master.zip

Unzip the download package via:

unzip master.zip

Create the ‘extensions’ directory for VLC if it is not exist.

mkdir -p ~/.local/share/vlc/lua/extensions

mv ‘vlsub.lua’ to that folder.

mv ~/vlsub-master/vlsub.lua ~/.local/share/vlc/lua/extensions


  • Start Vlc
  • Start your video
  • Click on the menu View > VLSub or VLC > Extension > VLSub if you’re on Mac OS X
  • Click on “Search by hash” or “Search by name”
  • Select a subtitles file on the list
  • Click on “Download selection”
  • That’s it, the subtitles should appear on your video.
  • If you’re not happy with your subtitles (wrong sync etc), you can select an other one and click “Download” again, that will erase the previous one and load it automatically.