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
- Issues and feature requests
Here are the current folders of vlc-android project:
- extension-api : Application extensions SDK (not released yet)
- application : Android application source code, organized by modules.
- buildsystem : Build scripts, CI and maven publication configuration
- libvlc : LibVLC gradle module, VLC source code will be cloned in
vlc/at root level.
- medialibrary : Medialibrary gradle module
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.
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.
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.
Native libraries are published on bintray. So you can:
- Build the application and get libraries via gradle dependencies (JVM build only)
- Build the whole app (LibVLC + Medialibrary + Application)
- Build LibVLC only, and get an .aar package
VLC-Android build relies on gradle build modes :
Debugwill get LibVLC and Medialibrary from Bintray, and build application source code only.
SignedReleasealso, but it will allow you to sign application apk with a local keystore.
Devwill build build LibVLC, Medialibrary, and then build the application with these binaries. (via build scripts only)
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.
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
$ANDROID_NDK to point to your Android NDK directory
Then, you are ready to build!
buildsystem/compile.sh -l -a <ABI>
ABI can be
all for a multi-abis build
You can do a library release build with
Build Medialibrary with
-ml instead of
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 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.
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.
- Android mailing list: email@example.com
- bugtracker: https://code.videolan.org/videolan/vlc-android/issues
- IRC: #videolan channel on freenode
- VideoLAN forum: https://forum.videolan.org/
Mobile App Development Best Practices – 28.09
iOS Decodable CoreData: A Proof-of-Concept for Building Offline-First iOS Apps The Future of Accessing User Location in SwiftUI Create SPM...
What is Dependency Injection
The primary goal of dependency injection is to reduce the coupling between components by removing the dependency resolution responsibility from...
Dependency Management in a Multi-Module Project – THIS Is How You Need to Do It
⭐ Learn how to make apps scale with a multi-module architecture.
Raspberry Pi 5 microcomputer unveiled
At launch, the Raspberry Pi 5 will come with several RAM options: $60 for the 4GB version and $80 for...
Cashew – Personal finances on Flutter
Cashew is a full-fledged, feature-rich application designed to empower users in managing their finances effectively. Built using Flutter – with...
Mobile App Development Best Practices – 27.09
Swipe Actions from Scratch, Effective code reviews for Android developers, WebP exploit and more!