libVLC
The libVLC (VLC SDK) media framework can be embedded into an application to get multimedia capabilities.
libVLC is a cross-platform audio and video API that provides a comprehensive multimedia API that can be used across mobile, server and desktop to render video and output audio as well as encode and stream.
Since VLC is based on libVLC, one should be able to have the same features that VLC media player has.
The libVLC media framework is already used by several applications; see who uses libVLC?
Contents
Features
libVLC notably can:
- Play every media file formats, every codec and every streaming protocols (RTSP, RTMP, Multicast, HLS/Dash/HDS, etc..)
- Run on every platform, from desktop (Windows, Linux, Mac) to mobile (Android, iOS) and TVs (AppleTV, Android TV, Tizen) and Consoles (PS4/5, Xbox)
- Hardware and efficient decoding on every platform, up to 8K
- Network browsing for distant filesystems (SMB, FTP, SFTP, NFS...) and servers (UPnP, DLNA)
- Playback of Audio CD, DVD and Bluray with menu navigation
- Support for 8K and HDR, including tonemapping for SDR streams
- Audio passthrough with SPDIF and HDMI, including for Audio HD codecs, like DD+, TrueHD or DTS-HD
- Support for complex video and audio filters
- Support for 360/VR video and 3D audio playback, including Ambisonics
- Able to cast and stream to distant renderers, like Chromecast and UPnP renderers.
libVLC, license and proprietary applications
Since libVLC is licensed under LGPLv2, one can do applications based on libVLC which are not licensed under the GPL (different open source licenses, or non-open source applications).
Documentation
Please refer to the Doxygen documentation, which is the reference documentation.
Make sure that the documentation matches the LibVLC version. (if not, you can build it from the source code)
Some further topics are covered here:
- LibVLC Memory Management explained: covers the basics on the
_new(),_retain(),_release(). - LibVLC Media List Management explained: covers the basics on setting up a playlist.
- Generate a .lib for using libVLC on Windows (before libVLC 2.1.0)
Examples
Playback
- Current version (1.1.x and later)
- Gtk Player: doc/libvlc/gtk_player.c
- Qt Player: doc/libvlc/QtPlayer/player.cpp
- WxWidgets Player: doc/libvlc/wx_player.cpp
Rendering and streaming
- Use LibVLC in an SDL application
- Stream into a memory zone
- Generate thumbnails using LibVLC: doc/libvlc/vlc-thumb.c
- Quick DVD ripper: doc/libvlc/libvlc_DVD_ripper.c
More complex examples
libVLC on Android
VLCKit for Cocoa (iOS/macOS)
You can find details on features and implementation on a designated page.
macOS
iOS
Crossplatform .NET/Mono support with LibVLCSharp
Outdated samples
- Versions 0.9.x and 1.0.x
- Version 0.8.6
- Visual C++ (uses "old" legacy API)
- VCL component for Delphi (out-of-date)
Language & platform bindings
LibVLC is a C library. It has bindings to the following languages and frameworks:
- C++, using the libvlcpp library
- The Web plugin for ActiveX (e.g. MSIE) and NPAPI (e.g. Firefox)
- WebChimera browser plugin with NW.js support
- WebChimera.js - another way to bind libvlc to node.js/io.js/NW.js/Electron
- Objective-C/Swift for iOS and macOS
- Perl
- Python
- Phonon (Qt/KDE) in C++
- Java
- Java/Scala/Kotlin/JNI Android
- C#/F#/.NET
- C++/CX
- Go
- Rust
- QmlVlc - Qt 5 QML binding
- VLC-Qt - Qt bindings
- wxWidgets MediaCtrl backend also in C++
- Using libvlc with Delphi
- Pascal/Delphi
- Tcl
- ActiveX with the built-in VLC browser plugin for MSIE (obsolete)
Compiling
To build LibVLC you need VLC source code and follow VLC compilation instructions since LibVLC it is directly shipped in VLC source code.
You will find headers in vlc-src/include/vlc and libvlc.so binaries in the hidden folder vlc-src/lib/.libs.
When using your custom LibVLC build you will need to define the environment variable VLC_PLUGIN_PATH pointing to VLC modules located in vlc-src/modules.
