/vlcj-player

Feature-rich example vlcj media player

Primary LanguageJava

You are currently looking at the development branch of vlcj-player for vlcj-4.0.0, if you want a stable version of vlcj-player that works with vlcj-3 you should switch to the vlcj-3.x branch.

vlcj-player

The vlcj-player is a media player application built using vlcj with a Swing rich-client user interface.

The main goal of the project is to provide an extensive demo application showing how to build media players with vlcj, and to include as many features of vlcj as possible.

Generally the vlcj-player tries to match the Qt interface of VLC with as many of the same features implemented as possible.

However, it is not possible to get a 100% like-for-like implementation since LibVLC, used by vlcj, exposes only a sub-set of the total functionality of VLC.

Screenshot

vlcj-player

Features

  • audio player
  • video player
  • full-screen
  • audio equalizer
  • video adjustments
  • title selection
  • chapter navigation
  • audio track selection
  • video track selection
  • subtitle track selection
  • load external subtitle file
  • change audio device
  • change audio stereo mode
  • change playback speed
  • capture and display native logs
  • capture and display video surface debug messages (e.g. to test mouse and keyboard events still work)
  • volume controls
  • mute
  • zoom/scale
  • aspect ratio
  • crop
  • logo/marquee
  • always on top
  • video snapshots
  • drag and drop local files to the main window
  • drag and drop URLs from web browsers to the main window (e.g. to play a YouTube video)
  • redirect native output streams (on Linux)

...and a whole bunch of other nifty stuff.

Status

This project is currently a work-in-progress.

If you execute "mvn install" or "mvn package", you will get a distribution package that you can unpack. This will give you the vlcj-player application jar and all of the dependencies - you can simply execute java -jar vlcj-player-1.0.0-SNAPSHOT.jar and the application should start.

On the other hand, just run it from an Eclipse project.

License

The vlcj-player project is provided under the GPL, version 3 or later.