VLC Extensions

Source (link to git-repo or to original if based on someone elses unmodified work): https://github.com/exebetche/vlsub

Score 86%

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

Search and download subtitles from opensubtitles.org 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/VLC.app/Contents/MacOS/share/lua/extensions/
* 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 2 years ago

Fix broken extension after opensubtitles uses a new CDN


3 years ago

Hi all

When I search for the subtitles, several show up in the list. However, when I click on the subtitle I would like to download, and press the "download" button, nothing happens.

Please find a copy of the log on http://pastebin.com/pe6PwEzY.

Thanks in advance!



3 years ago

Hi all

When I search for the subtitles, several show up in the list. However, when I click on the subtitle I would like to download, and press the "download" button, nothing happens.

Please find a copy of the log on http://pastebin.com/pe6PwEzY.

Thanks in advance!



3 years ago


for a long time, I got the message "Error: unable to save subtitles Click here to open the file" every time I used vlsub. But I' just found out a fix.

I am french, so my series folder is named "Séries". I changed it to "Series" (with an "e", not an "é") and I don't have an error anymore.
It seems that this error is caused by some characters in the path where you try to save the subtitles.

Hope it will help some of you.



3 years ago

I speak English but am not a programmer. I get the same error message: "Error: unable to save subtitles Click here to open the file"(and clicking there doesn't do anything.)
So 1: How and exactly where do I paste the following: "/Applications/VLC.app/Contents/MacOS/share/lua/extensions/"?
I tried pasting it in the window that is titled: VLSub Working Directory in "Configuration" but it just reverted to its original path.
And 2: The above instructions that say "To start the extension click on View > VLSub or Vlc > Extensions > VLSub on Mac OS." make no sense to me because the View tab has none of those choices.



3 years ago

A cherry on top of your great extension?



3 years ago

Hey, first of all nice addon! congrats!
I`m one of the guys that want the best subtitle for each movie I wanna watch, so as a Brazilian I always go to the legendas.tv and search for the best subtitle for that release and they are always excellent. Legendas.tv is the most used subtitle repository for portuguese (BR and Portugal) I can say 99.9% download subs from there. So it would be really great if you could integrate with them. Some guys already made an API in PHP (available here https://github.com/gustavosf/api.legendas.tv) that you could use as base for it.
You can ask me, ok but why you can't you the PT-br subtitles available on opensubtitles, my answer: most of the PT-br subtitles available there are Google Translated so there are a lot of errors and not synced well.

A friend of mine said to me a while go when he just bought his Macbook, "I miss BS Player that downloaded the subtitle automatically for me" and when I found out about VLSub I sent the link to him right away.

So for all the Brazilians, Portugueses and other countries that speak PT, it would be really really great if you could add an option to download subtitles from Legendas.tv (www.legendas.tv) it requires login and password but I saw on VLSub config that there are some inputs for it, great job :)
I hope you can find some time to improve this excellent addon and integrate with legendas.tv.

Thanks, and congratulations again for the job!



3 years ago

Hello to all,
Cannot save the subs in the movie folder anymore...and furthermore it does not rename them according to the movie name. It just pops up a link to download the sub and nothing more!
Any ideas on what should i do?



4 years ago

I know i am not using the latest verison*, but while it worked fine for several weeks, it stopped downloading subtitles files few days ago (the progress bar of the download status does not even start). Does the website changed something that this extensions is no longer able to "translate" ?

*The only way i manage to make it work (before the problem i mention above) is with VLC 2.0.8 and VLSub 0.9.10, Mac OS X 10.5.8, 32 bits.
I have tried since with every VLC version i can run and VLSub 0.9.1 and 0.9.13. Nothing worked.

I know you won't develop the 0.9.1 anymore, but do you have a guess of what i could modify in the luac file to try to fix the problem ?

Does anyone has the same downloading problem with 0.9.13 for several days ?



4 years ago

I have Vlc 2.2 and using vlc-sub 0.9. Everytime I go to download the subtitles, nothing happens. I'm using OSX 10.9.5. When I try to download a different version on VLC, the extension won't work. The extension only works on 2.2. HELP.



4 years ago

Also using osx, I've used pretty much all the nightlies out there and have gotten it working on some but have gone back to using vlc 2.08, the only version that works pretty stable (in my experience). The only thing I miss about the later versions of vlc is that it remembers where you left off watching, other than that I don't see any big feature updates so I'm just waiting for vlc 2x for mac to come :). Make sure to delete everything vlc related when downgrading (I use easyfind for this chore, enable hidden files and such http://www.macupdate.com/app/mac/11076/easyfind)



4 years ago

First I want to say that I am a VLC virgin. I've only been using it for a year or so and just now realized and found that there are so much more things that you can do with it.

I am trying to get VLSub to work and I followed the instructions as best I could and it's still not working. I've got Windows 7 Home Premium 64bit, as well as VLC Player Version 2.2.0-pre-3.

So, here is the url for the pastebin file that shows the messages in my VLC Player, http://pastebin.com/N52EgTDg, the errors at the end right when I press download selection is where it's stopping and not working.

Please Help Me!!!!!!!!

Thank you,





4 years ago

You have to download the last version of the script from here, the one included in Vlc is outdated. Then remove "C:\Program Files (x86)\VideoLAN\VLC\lua\extensions\VLSub.luac" and replace it with the new one, you should be ok.



4 years ago

Latest (0.9.13) VLSub working fine with it, and no interface focus switching issues anymore too (VLC related) :)



4 years ago

I have VLC ver 2.1.5 with your vsub ver 0.9.10 and it shows in view but does nothing. Im using win 7 32 bit. When a movie is running it will not open "view" at all.



4 years ago

As explained on top of the page :

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)



4 years ago

I have VLC ver 2.1.5 with your vsub ver 0.9.10 and it shows in view but does nothing. Im using win 7 32 bit. When a movie is running it will not open "view" at all.



4 years ago

I have VLC ver 2.1.5 with your vsub ver 0.9.10 and it shows in view but does nothing. Im using win 7 32 bit. When a movie is running it will not open "view" at all.



4 years ago

Why it doesnt work for steaming videos?
I click it but nothing happends, like i dint even click it (the button doesnt work)



4 years ago

First of all thanks for this wonderful plugin, it´s very useful.

I have one problem with spanish subtitles. When i am trying to download subtitles in spanish (using the hash search) it appears this error message or similar sometimes:
" Falló lectura de archivo" [Error file reading]
"VLC could not open the file "C:\[...]\Archer 1x04 - Killing Utne (Espa+â-¦ol (Espa+â-¦a)).srt.gz" (Bad file descriptor)."
"VLC could not open the file "C:\[...]\Constantine 1x01 - Pilot (Español (España)).srt.gz" (Bad file descriptor)."

"VLC could not open the file "C:\[...]\Archer 1x01 - Mole Hunt (Espa§ol (Espa§a)HDTV.XviD-SYS).srt.gz" (Bad file descriptor)."

But the .gz with the rigth subtitle file is in the same folder as the video. I think that maybe the problem is that it can´t handle the "ñ" letter when it appears in the subtitle file name.

I am using the last nightly of VLC (Because i want to use this plugin) for windows 7 X64

Thank you! :D



4 years ago

I have same problem while trying to download subtitles in finnish.

"File reading failed:
VLC could not open the file "Kirjastot\Documents\TVjaElokuvat\Family Guy - All seasons plus extras\Season 1\Family.Guy.s01e01.Death.Has.a.Shadow.XviD-SChiZO.srt.gz" (Bad file descriptor)."

My guess is that something cant handle ANY "special" letter such as åöä in finnish whether they are in filename or in the subtitles themselves.

But anyways I am running 2.2.0-pre3 on win7 64 if that will help to resolve things.



4 years ago


Despite having the config on "load and save", and not "manual download", the extension won't download and load the subtitles automatically. Instead, when clicking "download selection" I get a "download link", for a manual download.

What can I do to fix that?

Thanks for your help!

VLC version: 2.0.8
VLsub version: 0.9.13
OS: Windows 8.1
Debugging log: http://pastebin.com/geripdjE




4 years ago

I think I fixed it, could you download the script again and confirm it works.



4 years ago

why does the subtitle doesn't work in all movies? after i watched a movie, the next movie that i want to watch doesn't have any subtitles. how do i turn on the subtitle?




4 years ago

The Vlc extension system is instable and sometimes fail when you call a function when the movie change. So the best I can advice is to close the extension when you get your subtitles, and open the extension again to start a new search.



4 years ago

Hi !

This extensions seems really nice, however, i did not manage to make it worked.
Everything goes OK until i reach the "download link" displayed in green.
Search goes OK and when i hit "download selection", nothing happens except display the link which is not clickable (it is in blue but i can't do anything with it). And no subtitle file is being downloaded nor displaying on the video.
The link "VLSub working directory" in Config panel is not working better (if this is a link).

Besides, i have many "bugs" that can be related such as :
- once the extensions closes, i can't launch it a second time, but i can a third time.
- The buttons OK or Save or Close in different windows never close the windows but open the main one instead, above.

my config :
Mac OS 10.5.8 (can't update anymore) in french
VLC 2.0.8 (also tried 2.0.9) in french
VLSub 0.9.13 (anyway to get on older version ?) in english
searching for subs in english.

Last question : in config panel, what "user" and "password" are for ? filling them with my OS user is giving me more errors during search of subtitles. I leave them blank for now.

Thanks for your time


Support http chunked transfer encoding 2 years 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 fares555 Dec 06 2018

+شكرا لكم

product-maker ernhaka Oct 21 2018

i dont like the opensubtitles subs: - they insert advertising inside the movie! - they mention their name at the end of the subtitles, BEFORE the end of the movie, come on, could they wait the credits at least ? - many times the subs found are not accurate to the file, not synced, or HI Now i get subs from subscene, they're more reliable and less annoying. Too bad because VLSub was a great idea.

product-maker mohsen2694 Oct 13 2018


product-maker eyalkt Aug 10 2018

+ Works Great!

product-maker eyalkt Aug 09 2018


product-maker omda Jul 01 2018


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


Dec 06 2018


Oct 13 2018


Aug 11 2018


May 19 2018


Mar 24 2018


Mar 17 2018


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 Packagetype Architecture Downloads Date Filesize DL OCS-Install
updated Sep 05 2017
added Feb 07 2012
downloads today
page views today 1681
System Tags addon