How to Install a VLC Media Player Addon .lua

VLC Media Player, itself is a great one. If you are looking to play video and audio files along with other supported things like subtitles, VLC media player needs nothing else. But if you are one of those who require some unique features or who want to extend the functions of a software, then you probably heard about add-ons and plugins. VLC Media Player has a ton of those add-ons.

VLC Media Player allows you to add some new things to the player. You can do new tasks with the same player. Adding a skin to the player is kind of an extension but it is related to the user interface only. There are other types of add-ons which allows VLC to do something different like, load lyrics automatically for songs or load subtitles automatically for videos. Those are some of the possibilities of how VLC Media Player can be expanded to do much more.

First of all, it is necessary to understand a bit about VLC Media Player Addons. Here are a few things that you must know about them:

  1. When it comes to filetype, VLC Media Player add-ons is kind on unique. The files generally have a .lua extension. Although this extension is not unique to VLC, it still is quite a unique one for a normal PC user.
  2. VLC Media Player add-ons are developed by third-parties, who are interested in extending the possibilities of VLC’s usage. Generally those third-parties are promoting their own service(s) with VLC.
  3. VLC Addons are downloadable from the official VLC website. The url for it is:
  4. Addons or .lua files are downloaded and are copied to a location in the VLC’s program files directory to be installed. No fancy install wizard or anything of that nature.
  5. After copying the lua files, you will have to restart your VLC player or start a new instance of the player. Then depending upon the addon,you will find them on menu items. Click on those to activate them.

Where to copy lua files to?

VLC addon files are copied to VLC’s directory depending upon the OS. It also depends upon which users you are going to make available the add-ons for. The default ones are:

For All Users

In Windows: Program Files\VideoLAN\VLC\lua\extensions\
In Mac OS X: /Applications/
In Linux: /usr/lib/vlc/lua/playlist/ or /usr/share/vlc/lua/extensions/

For Current User

In Windows: %APPDATA%\vlc\lua\extensions\
In Mac OS X: /Users/%your_name%/Library/Application Support/org.videolan.vlc/lua/extensions/
In Linux: ~/.local/share/vlc/lua/extensions/

Note: You have to create the directories if they don’t exist. The final directory /extension in this case might not be the same for all addons. Some addons go into other directories of the lua folder like “playlist”.

How an Addon is Installed?

So, to install a VLC addon, you select one from the official VLC addon website ( and download it. Then you copy the downloaded file to the location mentioned above, depending on your OS. Then you restart VLC and you’re done.

Free Download: 10 Hidden but Useful Features of VLC

A handy PDF guide to learn the secret features of your favorite media player
* indicates required

9 thoughts to “How to Install a VLC Media Player Addon .lua”

  1. Most of the above problems in this situation and many others will be solved by using “Ctrl + Click”
    ie Hold down the “Control” key and “Click” the mouse.
    Much less trouble than getting upset.

  2. But use it where? I managed to download the files with ease, and copied where I was told. Also, restarted the vlc app. But Idk where to find the add-ons i’ve downloaded. Can someone help?

  3. This is a nightmare. Can’t install this stuff on a Mac and I’m a second year Computer Science student. Why not ad a damn “install extension” in the program it self. But copying files to folders half of the people can’t even get into without guidance from an IT-professional and then it not working as it should.

    1. The .lua-files are not being downloaded correctly in Mac OS. Safari just opens them as if it were a web-page and the source code is presented in the browser instead of downloading the file.

    2. Once you manage to somehow get the file on to your computer and save it as a .lua-file. You have to copy it to the VLC-folder. Now for me it’s not a problem opening it but I bet you 90% of the people are just going to get to that applications folder and start double-clicking the VLC icon trying to open the folder and end ut with starting VLC and get frustrated as they can’t find any folder.

    3. Once you open the folder and copy the files into those katalogs that are mentioned and restart VLC you get absolutely nothing. NADA!

    So to the VLC developers I have one thing to say. It’s something that I have been thought from the military and that is: “Do it again and do it right!”

    1. Sillen your ignorance is the problem here, not the program.

      VLC is not some ill-conceived amateur trash-ware for the inexperienced user to point and click their way to digital enlightenment. It is a complex and highly configurable, modular client/server interface with an emphasis on functionality with a moderate learning curve. Because of the modular design, usability can appear obfuscated and nonsensical to the uninitiated. Most commercial products (gratis or otherwise) restrict functionality by handicapping the user with licensing conditions, proprietary restrictions or design philosophies that appeal to the lowest common denominator.

      Consider why you couldn’t save the .lua file in Safari (did you try another browser or past the code into a text editor?) As a second year computer science student you should know this, or at the very least know how to use a search engine.

      VLC is not perfect but it is powerful, reliable and free of cost and is (mostly) GPL so stop giving the military a reach-around and change what you don’t like.

  4. shit I can’t manage to download the files on my mac. Trying to download the “time” extension, but whenever i click on download, a new tab open with only text in it.

Leave a Reply