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


11 days ago

Just upgraded VLC player to version 3.0.0 on Windows 10. Now, if I try to search for subtitles with VLSub I get an error:

Error: code '503 Service Unavailable' (200)

Any ideas on fixes?




15 days ago

Just upgraded VLC player to version 3.0.0 on Windows 10. Now, if I try to search for subtitles with VLSub 10, it crashes the player.

I guess the extension doesn't work for this newest version of VLC. Any plans to fix that?



15 days ago

I see I made a mistake in my post. I'm, of course, using VLSsub 0.10.0



1 month ago

Fix for Error: "Extention not responding!
Extention 'VLsub 0.10.0' does not respond.

Open your extension from VideoLAN\VLC\lua\extensions ( on windows 10)

Open files in Notepad++ or any hex editor.
Search for HTTP, (CTRL + F in notepad++)
Find the following
HTTPVersion = "1.1"
Change it to - HTTPVersion = "1.0"
That is, change 1.1 to 1.0

Replace or save the file. This worked for me.

Video from the original source below.




20 days ago

That fixed the error.
Many thanks for the tip, my friend.



2 months ago




3 months ago

VLSub still needs SSL support. I just update some of the languages with the VLC translators and put them on my forked version. This version has also a workaround link for the online translations, now on pastebin, that uses also http and is reachable by VLSub.
If you want to have this updated translations or a working download link for them just
use my updated version. More details you'll find on the github forum here:

SSL could be very important for VLSub, when also opensubtitles change his services completely to SSL someday, this extension won't work anymore. It's not so easy to include SSL support in VLSub, we need someone with more lua skills but we must keep that in mind, that this unsolved issue can make VLSub useless someday.



3 months ago

SubVLC crunches when searching for spanish subtitles.

vlc.log.text at

Version 3.0.0
OS Windows 10 x64

Any help provided?



3 months ago

Good afternoon. Any clue on how to deal with "Code 401 Unauthorized 200"?



3 months ago

As found on page 6, is because require login information. Create an account there, fill in the information in the vlsubs config, and you are good to go.



4 months ago

I have a problem with VLSub. When i try to download a subtitle it crushes "extension not responding, kill it now".
I ran a debugging and this is the result



4 months ago

merci pour ce magnifique addon qui a "changé ma vie". Bonne continuation.



4 months ago




4 months ago

This one works great! Awesome



4 months ago

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



4 months ago

I have a problem with this great tool that worked for me for a long time, now, it is just freezing on my Mac:
Here is the log file

Can someone please help




4 months ago

Well that's weird, the error says "unexpected symbol near '<' on line 4", but there is no '<' character on line 4...
You should check if the script you have on your computer is really the same as the latest version here:
The path of the script on your computer is that:
/Users/darko.vukoje/Library/Application Support/org.videolan.vlc/lua/extensions/vlsub.lua
Maybe a VLC update that failed?



4 months ago

It works now with the new file you provided. Thanks a lot !



6 months ago

Hey there,

I get the following whenever I try to download a subtitle:

"Extention not responding!
Extention 'VLsub 0.10.0' does not respond.
Do you want to kill it now?

The only way out of this dialog box is by clicking "Yes". I don't get an error log after this. VLC just continues working after the extention is killed. Can anyone help? I can search for the subtitles file, either by hash or by name, it's only when I try to download them that this happens.

I'm on Mac OS Sierra.

Thank you for the help.



6 months ago

I installed the new version (didn't know there was one) and this is now fixed.



7 months ago

Does the job :-) Thanks for the work!



6 months ago

where i find the word dawolond plz



7 months ago




8 months ago




9 months ago

I have an issue. VLSub 0.10 searches the subtitles and they're displayed, but when I hit Download selection, it displays "Downloading Subtitles" but nothing happens, and then "Extension not responding. Do you want to kill it?" What to do?
I'm using VLC 2.2.4


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