libvlcjni
This is the official LibVLC bindings for Android.
Project Structure
Here are the current folders of vlc-android project:
- buildsystem : Build scripts, CI and maven publication configuration
- libvlc : LibVLC gradle module, VLC source code will be cloned in
vlc/
at root level.
LibVLC
LibVLC is the Android library embedding VLC engine, which provides a lot of multimedia features, like:
- Play every media file formats, every codec and every streaming protocols
- 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 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 video and audio filters
- Support for 360 video and 3D audio playback, including Ambisonics
- Ability to cast and stream to distant renderers, like Chromecast and UPnP renderers.
And more.
You can use our LibVLC module to power your own Android media player.
Download the .aar
directly from Maven or build from source.
Have a look at our sample codes.
License
libvlcjni is licensed under LGPLv2.
Build
Build LibVLC
You will need a recent Linux distribution to build VLC. It should work with Windows 10, and macOS, but there is no official support for this.
Setup
Check our AndroidCompile wiki page, especially for build dependencies.
Here are the essential points:
On Debian/Ubuntu, install the required dependencies:
sudo apt install automake ant autopoint cmake build-essential libtool-bin \
patch pkg-config protobuf-compiler ragel subversion unzip git \
openjdk-8-jre openjdk-8-jdk flex python wget
Setup the build environment:
Set $ANDROID_SDK
to point to your Android SDK directory
export ANDROID_SDK=/path/to/android-sdk
Set $ANDROID_NDK
to point to your Android NDK directory
export ANDROID_NDK=/path/to/android-ndk
Then, you are ready to build!
Build
buildsystem/compile.sh -l -a <ABI>
ABI can be arm
, arm64
, x86
, x86_64
or all
for a multi-abis build
You can do a library release build with -r
argument
Contribute
libvlcjni is a libre and open source project, we welcome all contributions.
Just respect our Code of Conduct.
Pull requests
Pull requests must be proposed on our gitlab server.
So you must create an account, fork libvlcjni project, and open your merge requests from it.
Issues and feature requests
The libvlcjni bugtracker is hosted on VideoLAN gitlab
Please look for existing issues and provide as much useful details as you can (e.g. vlc app version, device and Android version).
A template is provided, please use it!
Issues without relevant information will be ignored, we cannot help in this case.
Support
- bugtracker: https://code.videolan.org/videolan/libvlcjni/issues
- IRC: #videolan channel on freenode
- VideoLAN forum: https://forum.videolan.org