VLSub is not working with Vlc 2.1.x, please update to 2.2.

Search and download subtitles from using the hash of the video currently playing or its title.
- download the file from the "Files" tab above
- create a directory "extensions" at this location and put the file "vlsub.lua" inside:
* Windows (all users): %ProgramFiles%VideoLANVLCluaextensions
* Windows (current user): %APPDATA%vlcluaextensions
* 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/

...or use the installer below if you're on Windows 7 (32 or 64)

To start the extension click on View > VLSub or Vlc > Extensions > VLSub on Mac OS.


* Impossible to automatically save the subtitles on Windows if the path to your video contain non ASCII (non-english) characters and the "search by hash" method will be slower.
* The "search by hash" method will fail on Windows if for video files >2Go (if VLC is compiled with lua 5.1 anyway)

/! Troubleshooting /!

If you have other issue you can ask for a solution here or on github but please get the full vlc debug log and add it as a pastebin to your post. The procedure is explained here:
Last changelog:

Support http chunked transfer encoding 1 year ago

Fix broken extension after opensubtitles uses a new CDN


1 year ago

-- logger module started --
main debug: using interface module "logger"
main debug: TIMER module_need() : 146.643 ms - Total 146.643 ms / 1 intvls (Avg 146.643 ms)
main debug: looking for interface module: 1 candidate
main debug: using interface module "globalhotkeys"
main debug: TIMER module_need() : 10.319 ms - Total 10.319 ms / 1 intvls (Avg 10.319 ms)
main: Running vlc with the default interface. Use 'cvlc' to use vlc without interface.
main debug: looking for interface module: 4 candidates
main debug: playlist threads correctly activated
main debug: rebuilding array of current - root Playlist
main debug: rebuild done - 0 items, index -1
main debug: looking for extension module: 1 candidate
lua debug: Opening Lua Extension module
lua debug: Trying Lua scripts in C:\Users\ManinderJeet Singh\AppData\Roaming\vlc\lua\extensions
lua debug: Trying Lua scripts in C:\Program Files (x86)\VideoLAN\VLC\lua\extensions
main debug: using extension module "lua"
main debug: TIMER module_need() : 10.283 ms - Total 10.283 ms / 1 intvls (Avg 10.283 ms)
main debug: looking for services probe module: 6 candidates
main debug: no services probe module matching "any" could be loaded
main debug: TIMER module_need() : 11.359 ms - Total 11.359 ms / 1 intvls (Avg 11.359 ms)
qt4 debug: Sorting by column -1, order 0
qt4 debug: Sorting by column -1, order 0
qt4 debug: Normal PL/ML or SD
qt4 debug: Normal PL/ML or SD
main debug: using interface module "qt4"
main debug: TIMER module_need() : 155.295 ms - Total 155.295 ms / 1 intvls (Avg 155.295 ms)
main debug: exiting
main debug: deactivating the playlist
main debug: deactivating the playlist
main debug: saving Media Library to file C:\Users\ManinderJeet Singh\AppData\Roaming\vlc\ml.xspf
main debug: looking for playlist export module: 1 candidate
main debug: using playlist export module "export"
main debug: TIMER module_need() : 3.977 ms - Total 3.977 ms / 1 intvls (Avg 3.977 ms)
main debug: removing module "export"
main debug: playlist correctly deactivated
main debug: removing all services discovery tasks
main debug: removing all interfaces
main debug: removing module "qt4"
qt4 debug: requesting exit...
qt4 debug: QApp exec() finished
qt4 debug: waiting for UI thread...
qt4 debug: Video is not needed anymore
qt4 debug: Killing extension dialog provider
qt4 debug: ExtensionsDialogProvider is quitting...
main debug: removing module "lua"
lua debug: Deactivating all loaded extensions
lua debug: All extensions are now deactivated
qt4 debug: Playlist Destroyed
main debug: removing module "globalhotkeys"
main debug: removing module "logger"
-- logger module stopped --

cannot see vlcsub option in view
operating system windows 8 64bit
vlc 2.0.7



2 years ago

cant find the installer download button for windows 7 and iam in windows 7.. plz help



2 years ago

Hi, I've noticed that it stops on "calculating movie hash" when movies are big, 5GB or more.



2 years ago

Hello,every time i use a theme...i tryed many..when i go to vlsub and press it..vlc crashes...why?




2 years ago

You should ask the Vlc team about that, maybe reoprt a bug:



2 years ago

Vlsub hangs with green bar complete but with no subs shown as result.



2 years ago

Same here!



2 years ago



2 years ago

Same here, no any results and search bar progress stay still.
I am on MacOS , Vlc 2.2.1



2 years ago

It can find the subtitles but it doesn't download them. When i click to download button I can see the green bar but it doesn't download anything. I tried on many different movies.



2 years ago

it doesnt show any subtitle when I click on search botton....



2 years ago

You inform us the following:
VLSub is not working with Vlc 2.1.x, you can use one of these versions instead:
-Vlc 2.0.8 (stable)
- Vlc 2.2 (pre release)

Yet I have done exactly that and it still does not work and keeps showing Error: code '401 Unauthorised' (200)
This is so frustrating how many times do I have to download and try it.
I have been using VLC and VLSub for years now and only until about a week ago it has been working fine......what has happened? and why cant it be fixed?




2 years ago

I'm not sure but I think that when opensubtitles start being overloaded, it serves the requests only for the logged-in users, perhaps as defense again ddos, I don't know.
So try this:
- create an account on
- on VLsub, click on "Config" and fill the field user name and password and save
- restart

I hope this helps



2 years ago

I'm running on Windows 10, my VLC version is 2.2.1.

While using Popcorn Time and trying to stream through VLC, every time I try to open VLsub, simply nothing happens. (I haven't tried to stream from other sources, but I'd be disposed to do it in order to fix the bug).

Here's the debug console output:

I really hope this could be fixed.



2 years ago

Ok, as long as I understand, the problem is that Popcorn Time "tells" VLC that the name of the video is a local IP, so VLsub cannot search by hash, am I wrong?

What could I modify in order to open VLsub while streaming, manually introduce the name of the video I'm streaming and save and load the subtitle?



2 years ago

Using VLC 2.2.1 and Win 8.1 (x64).

Unable to download subtitles running VLC as non-admin.

Able to load subs but not to save them running VLC as admin.



2 years ago


First of all, thanks for the great work. This should be really magnificent and make watching foreign films so much easier and simpler.

Unfortunately I seem to be unable to use it. After choosing and downloading a sub file I get a success (Subtitles loaded) and an error (Unable to save subtitles).

What can I do? If you need a log - where would I get it?

I'm on MacOS 10.10.4 and VLC 2.0.9 (I am also unable to update to 2.2.0 - maybe something is wrong with my VLC?)

Thanks in advance!




2 years ago

Hi and thanks. I can't tell you what the problem is, it might be that Vlc has read only access to the folder where your movie is stored. You cold try to put them in an other folder on your main partition to see if it works.
You can get the debug log in Tools > messages and set verbosity level to 2 before you try to save the subtitles. But I don't think the log will give you the reason why it can't write on this folder so it won't help.



2 years ago

Here is the error dump:

/extensions/VLSub.lua:1641: attempt to concatenate field 'SubSumCD' (a nil value)

Any ideas?



2 years ago

Hi exebetche,

It work fine in vlc 2.2.
I update Basque translation and attached here link:
[url=]basque update[/url]



2 years ago

Hi, I have been using vlsub successfully (with a few server errors here and there) for a few weeks, since getting the latest VLC that includes it in the install.
Today it started behaving in a new way - finding the necessary subs files but 'sticking' [with a displayed full progress bar] on the "downloading subtitles" step. a rar file and autorenamed sub file appear in the directory, but the extension hangs and the subs do not function.




2 years ago

I think change their policy on downloading, now it works only if you create a user account on their website and enter your username and password on "Config" in VLsub, otherwise the download is blocked.



2 years ago

interesting. that would have had to have been a very very recent change. I'll see if it fixes it.



2 years ago

Tentatively, I'd say that fixed it. Thanks!




2 years ago

You're welcome. I hope I'll find something else to fix that problem later.


Support http chunked transfer encoding 1 year ago

Fix broken extension after opensubtitles uses a new CDN

6 years ago

Fix error with http 301 redirection

Fix subtitles loading on Vlc 2.2

Fix a bug due to opensubtitles header modifications

product-maker rvs75 Feb 27 2018

product-maker D64134n0 Oct 20 2017

product-maker ahmedsaber333 Oct 13 2017

product-maker vinnusaurus Oct 12 2017

product-maker pardeep84 Oct 12 2017


product-maker sapeletv Oct 02 2017

men this is wonderful...cant believe i didnt have this all this while. thanks much

product-maker king021 Oct 01 2017

product-maker Medo@22 Sep 05 2017

product-maker totophe Jul 21 2017

Does the job :-) Thanks for the work!

product-maker alialkhawaja Jul 20 2017


product-maker Abhishek May 06 2017

product-maker hamedsoltan Apr 06 2017

product-maker franksalexa Mar 08 2017

product-maker sampo2013 Feb 15 2017

product-maker rbibouh Feb 14 2017

product-maker csola48 Jan 29 2017

product-maker m0hdasif Jan 19 2017

product-maker lazarus Jan 18 2017

product-maker elmenady Jan 17 2017

product-maker john50cent Jan 10 2017

product-maker stefansundin Dec 31 2016

product-maker 6l9fN967 Dec 24 2016

product-maker dummy Dec 13 2016

product-maker j1402 Dec 13 2016

product-maker Rafracra Dec 06 2016

product-maker Yuvesh Dec 04 2016

product-maker kaotik808 Nov 29 2016

product-maker luiscarmona Nov 27 2016

product-maker akhterpalash Nov 25 2016

product-maker AleksaD Nov 12 2016

product-maker vargapirot Nov 08 2016

product-maker ruineves1994 Nov 07 2016

product-maker tmmam Nov 03 2016

product-maker Eldo Oct 28 2016

product-maker vamsi22 Oct 15 2016

product-maker khatrisingh Oct 14 2016

product-maker nhad22 Oct 03 2016

product-maker exebetche Sep 26 2016

product-maker lotfi333 Sep 23 2016

product-maker Frelle Dec 26 2015

product-maker Ragiowan Nov 09 2015

product-maker alextabs Oct 29 2015

product-maker j4eo Oct 27 2015

product-maker k0b32010 Oct 08 2015

product-maker dkarnout Jul 05 2015

product-maker Danielbreezy May 23 2015

product-maker ameirefke Apr 11 2015

product-maker marvael Mar 02 2015

product-maker ilariadorsi Dec 01 2014

product-maker karpa Oct 22 2014

product-maker techster Oct 21 2014

product-maker Niwol Sep 30 2014

product-maker Schwarzkopf Sep 17 2014

product-maker dcos77 May 24 2014

product-maker jordibabot May 19 2014

product-maker havocmker May 13 2014

product-maker Tibus May 01 2014

product-maker robysottini Apr 29 2014

product-maker lean766 Mar 07 2014

product-maker DFPOWER46 Nov 18 2013

product-maker whoodini Nov 15 2013

product-maker unnicked Nov 03 2013

product-maker Simekuk Sep 19 2013

product-maker voiturebleue Sep 19 2013

product-maker PrakashCh Sep 08 2013

product-maker dux2 Aug 30 2013

product-maker BTKL Aug 30 2013

product-maker thorin Aug 18 2013

product-maker alex9r Aug 17 2013

product-maker Meldi Aug 16 2013

product-maker mastodon Jul 31 2013

product-maker nunomazer Jun 12 2013

product-maker Azpidatziak May 24 2013

product-maker kapcom01 May 19 2013

product-maker Deathmachine May 18 2013

product-maker grzegorz451 Apr 30 2013

product-maker boldyzno Apr 30 2013

product-maker Babalui22 Apr 29 2013

product-maker hackerz222 Apr 18 2013

product-maker cipricus Mar 27 2013

product-maker zequi Feb 12 2013

product-maker hdiffly Oct 20 2012

product-maker klacs Oct 09 2012

product-maker tariquenor Sep 12 2012

product-maker Chematronix Jul 27 2012

product-maker Navid Jul 20 2012

product-maker Aglo Jul 02 2012

product-maker Cardellos Jun 22 2012

product-maker GuixLe Apr 28 2012

product-maker FracExebetche Apr 23 2012

product-maker BlueK Mar 11 2012

product-maker yapaca Feb 11 2012

product-maker 6 6


Feb 24 2018


Jan 24 2016


Oct 27 2015


May 06 2015


Dec 01 2014


Oct 21 2014


Sep 08 2014


May 27 2014


May 19 2014


May 18 2014


May 18 2014


May 01 2014


Jan 05 2014


Nov 23 2013


Nov 15 2013


Oct 23 2013


Sep 17 2013


Aug 30 2013


Aug 18 2013


Jul 21 2013


May 24 2013


May 13 2013


Apr 30 2013


Apr 22 2013


Mar 19 2013


Feb 12 2013


Jan 05 2013


Nov 27 2012


Nov 22 2012


Jul 27 2012


Jul 25 2012


Jul 02 2012


Jun 26 2012


Apr 23 2012


Feb 25 2012
File (click to download) Version Description Filetype Packagetype License Downloads Date Filesize DL OCS-Install
updated Sep 05 2017
added Feb 07 2012
downloads today
page views today 784