Home

Awesome

VLC for Android

This is the official Android port of VLC.

VLC on Android plays all the same files as the classical version of VLC, and features a media database for Audio and Video files and stream.

Project Structure

Here are the current folders of vlc-android project:

LibVLC

LibVLC is the Android library embedding VLC engine, which provides a lot of multimedia features, like:

And more.

LibVLC stack

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

VLC for Android is licensed under GPLv2 (or later). Android libraries make this, de facto, a GPLv3 application.

VLC engine (LibVLC) for Android is licensed under LGPLv2.

Build

Native libraries are published on bintray. So you can:

Build Application

VLC-Android build relies on gradle build modes :

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

Medialibrary

Build Medialibrary with -ml instead of -l

Contribute

VLC is a libre and open source project, we welcome all contributions.

Just respect our Code of Conduct, and if you want do contribute to the UI or add a new feature, please open an issue first so there can be a discussion about it.

Pull requests

Pull requests must be proposed on our gitlab server.

So you must create an account, fork vlc-android project, and propose your merge requests from it.

Except for translations, see the section below.

Translations

You can help improving translations too by joining the transifex vlc project

Translations merge requests are then generated from transifex work.

Issues and feature requests

VLC for Android 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