Skip to content
This repository

Java framework for the vlc media player



The vlcj project provides a Java framework to allow an instance of a native vlc media player to be embedded in a Java AWT Window or Swing JFrame.

You get more than just simple bindings, you also get a higher level framework that hides a lot of the complexities of working with LibVLC.

vlcj is primarily developed and therefore extensively tested on Linux - it does also work just fine on Windows and MacOSX.

At least JDK 1.6 is required, and it works without changes on JDK 1.7.

This is the open source vlcj project page, see also the 'official' home page where you can find more information as well as some new simple tutorials.

Version 3.0.0+ of vlcj requires version 2.1.0+ of vlc, earlier versions of vlc are not supported and will not work.

Version 3.0.0+ of vlcj requires version 4.0.0+ of JNA.

Some features of version 3.0.0+ of vlcj (such as the new audio equalizer API) require version 2.2.0+ of vlc (which has not yet been released).

If you still need to use vlc 2.0.x then you must stay with vlcj 2.x.x instead of upgrading to the new vlcj 3.0.0 series.

Maven Dependency

Add the following Maven dependency to your own project pom.xml:



10/01/2014 Made new release 3.0.0 at Maven Central, new audio equalizer API, new native full-screen implementation for Windows, some little-used deprecated features removed, minor bugs fixed.

Version 3.0.0+ of vlcj requires version 2.1.0+ of vlc, earlier versions of vlc are not supported and will not work.

You can also follow @capricasoftware on Twitter for more vlcj news.


The vlcj project page is at github.

Online Javadoc is available:

Documentation is being made available at Caprica Software.


Free support for Open Source and non-commercial projects is generally provided - you can use github issues for this purpose.

Support for commercial projects is provided exclusively on commercial terms - send an email to the following address for more information:

mark [dot] lee [at] capricasoftware [dot] co [dot] uk


The vlcj framework is provided under the GPL, version 3 or later.

If you want to consider a commercial license for vlcj that allows you to use and redistribute vlcj without complying with the GPL then send your proposal to:

mark [dot] lee [at] capricasoftware [dot] co [dot] uk

Something went wrong with that request. Please try again.