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


2 months ago

ya same problem



9 months ago

Extension VLsub 0.10.0 no responde



9 months ago


I need assistance with VLSub 0.10.0. I am able to search for the subtitles but then VLSub crashes VLC ("Extension not responding") when I try to download them. Log file provided here:
I'm in macOS Sierra 10.12.3 and VLC 2.2.4. Would greatly appreciate your help.



9 months ago


I've got a problem on VLsub using 0.10.2
When I search for subtitles, I got this error: code '401 Unauthorized' (200)
Here is the log file, anything seems wrong here:
Any suggestion?
I'm on VLC 2.2.2 and elementaryOS.



9 months ago

I solved my problem. I put something in "username" and "password", keep that empy and you are ready to go...



9 months ago

VLSub 0.10.0 is giving me problems. Where can I get version 0.10.2? I can only see version 0.10.0 being offered on this site. Thanks.



9 months ago right-top > clone or download :)



9 months ago

Done and now it works. It would be interesting though that someone updates the Change Log because it still mentions that it's version 0.10.0. Thank you!



9 months ago



9 months ago

I don't have access to this account since the website has been updated few months ago. I can't update anything.



9 months ago

Have you tried contacting the opendesktop Team? They can probably reset your password to gain access again.



9 months ago

How can be set than default menu language the Hungarian (hun)?
Default language by replacing nil with example:

-- language = "hun", in the
local options = {
language = nil, <==== ?

Where is he the vlsub_master "locale" the place of a folder?



9 months ago

The language support seems to be broken (at least that's what it looked like when I tried to apply a patch for Finnish language). I'll try to fix it when I have so time. The original developer hasn't been providing any patches lately.



9 months ago

vlsub.lue 0.10.0 (Ubuntu 16.04.1, VLC 2.2.2) not works... :(



9 months ago

0.10.2 working :)



9 months ago

@varjolintu It's working now.......
Thnx for all the HELP



9 months ago

@varjolintu that is also not working
and also my internet connection is fine........
when i download a subtitle the pop up appears and say that u have to kill it but after 1-2 min. later subtitle gets downloaded automatically........this problem did not appear before me earlier......HELP



9 months ago

Are you sure VLC is reporting the version number as 0.10.2 when looking at the VLC Extensions menu? If not, you have not installed the latest version correctly.



9 months ago

You are a genius,it was only ...patience!



9 months ago

You can download the latest version 0.10.2 from It works.



9 months ago

extension vlc 0.10.0 does not respon
been this for a few days
do somethin 'bout it VLC TEAM



10 months ago

hello. for me this fix work fine.
only replace the HTTP/1.1 by HTTP/1.0 inside the file VLSub.luac,
check this video for instructions



10 months ago

VLsub stucks when I click to search.



10 months ago

Salutations :)

Windows 8.1 64b, VLC 64b 2.2.4.

J'avais des gros soucis avec le greffon, il ne répondait plus et ne retournait aucun résultat. J'ai pu résoudre le souci manuellement comme ceci apparemment (sans comprendre ce qui ne va pas précisément).

- fermer VLC.

- supprimer fichier vlsub.lua dans :

- supprimer répertoire vlsub dans :

Puis j'ai manuellement copié le dernier fichier uniquement vlsub.lua (0.10.0 qui provient d'ici dans :

Le greffon fonctionne alors sans souci -par hash ou nom- (sinon que je n'arrive pas à le 'franciser' via l'interface qui ne répond plus).

Windows 8.1 64b, VLC 64b 2.2.4. Manually fix problems.

- shut down VLC

- delete manually all file vlsub.lua in :

- delete manually folder vlsub in

Save file vlcsub.lua (0.10.0 from here in

Seems working for research by hash ou name.
Only the choice of language of interface seems doesn't work.



10 months ago

Thanks for the solution. Works fine!!!!


Support http chunked transfer encoding 1 year ago

Fix broken extension after opensubtitles uses a new CDN

5 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 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

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