Best VLC Extensions (Lua Plugins) — Install & Manage

extension Last updated:

VLC extensions are small Lua scripts that hook into the player to add functionality: fetching subtitles, showing media info, controlling playback from a web interface, and more. They are distributed as .lua files or .vlp packages. This guide explains the safe way to get, install and manage them — with the important rule: only install extensions from trusted sources, because an extension runs with your user permissions.

Where to get extensions officially

The official source is the VideoLAN add-ons site (addons.videolan.org) — it lists extensions and skins that have passed the project's review. GitHub repositories of well-known developers are a second acceptable source. Any other site claiming "VLC extensions" should be treated as a malware risk: a Lua script can execute commands on your machine.

Installing an extension

Download the .lua (or .vlp) file and place it in the VLC extensions folder: %APPDATA%\vlc\lua\extensions (Windows), ~/Library/Application Support/org.videolan.vlc/lua/extensions (macOS) or ~/.local/share/vlc/lua/extensions (Linux). Restart VLC. The extension appears under the View menu (or its own menu).

Managing and removing

To remove an extension, delete its file and restart VLC. To temporarily disable all extensions — useful when VLC crashes at startup — rename the whole lua folder to lua.bak (see the crash fixes on this site).

Recommended extensions

VLSub (now "Subtitles") — downloads subtitles from OpenSubtitles inside VLC. Playlist random/export tools — batch playlist utilities. Web interface — control VLC from a browser on the same network. Always verify the current state of these on addons.videolan.org before installing.

Frequently asked questions

Are VLC extensions safe?
Official addons.videolan.org listings are reviewed. Anything from random download sites is dangerous — Lua extensions have full user-level access. When in doubt, run them in a sandbox or skip them.
Why does my extension not show up?
Check the folder path (per-OS above), the file extension (.lua not .txt), and restart VLC completely. On macOS, check folder access permissions for VLC.
VLC crashes since I installed an extension
Disable extensions by renaming the lua folder to lua.bak, restart, and re-enable extensions one by one to find the culprit (see vlc-keeps-crashing on this site).