Vlc on android source

VLC for Android™

Features

• Plays all files, in all formats, like the classic VLC.
• Audio and video media library, with full search and history.
• Support for network streams, including HLS and Dash.
• Support for NAS and shared drives browsing.
• Supports Android Version 2.2 (platform-8) or later.
• Supports ARMv7, ARMv8 / AArch64, MIPS and x86.
• Support Android TV.
• Support Chromebooks.

• Subtitles support, embedded and external, including ASS and DVD subtitles.
• Multi audio or subtitles tracks selection.
• Multi-core and full hardware decoding.
• Gestures, headphones control.
• Audio equalizer and filters.
• Supports secondary display.
• Supports 360 video and 3D audio.

Help us!

Test it

We need help to test VLC under a variety of devices.
Please join us on our forum to provide feedback and get assistance with any issues you might have.

Send us phones

If you are a phone manufacturer or have spare phones, please send them to us 🙂
Contact us.

Decoding performance

VLC can decode video in software and hardware mode. Hardware decoding often provides better performance but is not supported on all devices. If your device Android version is below 4.3, software decoding may be the only supported option for you.

Documentation

We have documentation available on our wiki — please have a look here.

Источник

AndroidCompile

This page is an introduction to the compilation of VLC for Android on Linux.

Contents

Android Studio, SDK and NDK installation

Requirements

• You MUST build on Linux (or OSX if you know what you are doing).
• The following packages MUST must be installed:
  • the GNU autotools: autoconf, libtool, automake and make (a.k.a. gmake)
  • . and their dependencies: m4 and gawk, mawk or nawk,
  • the GNU C and C++ compilers a.k.a. gcc and g++,
  • some GNU build utilities: pkg-config and patch,
  • the following other build utilities: Apache Ant (or Ant), cmake, protobuf, ragel,
  • the Subversion and Git version control systems
  • unzip and either curl or wget for retreiving sources.
• Very recent versions of some of those tools may be required. At the time of writing, notably gettext 0.19.3 or later is required.
• If any of the above is missing, expect the build to fail at some point.
• If targeting an Android-x86 device, yasm must be installed too.

Precise lists of tools dependencies is listed here.

64-bit users : You must install these 32-bit libs as specified here: #Can.27t_run_aapt_or_adb_on_Linux_64-bit

Example on Ubuntu

Install the packages as follow:

SDK & Android Studio

1. Go to Android SDK/IDE page.
2. Android Studio is recommended, but not mandatory!

Android NDK

1. Check that the SDK installation is correct.
2. Go to the Android NDK page and download the NDK r21 for Linux.
3. Decompress it to install

Environment setup

Set $ANDROID_SDK to point to your Android SDK directory

Set $ANDROID_NDK to point to your Android NDK directory

Add some useful binaries to your $PATH

Building

Get VLC Source

Clone the source from the VLC git!

In your android source folder, run:

Setup Gradle build system

Before using Android studio to compile the app, you must run compile.sh once to set up gradle build system.

It should automatically populate mandatory local.properties and gradle.properties files with:

This sets up gradle to build with correct SDK/NDK.

Once this first compilation has succeeded, you can build from Android Studio with the Run command.

Devices

Find the ABI for the target device.

• For a normal (2012-2015 consumer phone or tablet) device (e.g. Cortex-A8 or Cortex-A9)

• For a Tegra2 device (no NEON)

• For an ARMv6 device

• For an ARMv6 device that does not support FPU

• For an ARMv5 device or the Android Emulator

• For a x86 device (e.g. Android-x86, Google TV, Logitech TV, Android x86 smartphones, etc)

• For a MIPS device (i.e. Ainol Novo tablets):

This value must be passed to the compile.sh script

Compile

Read compile.sh first, as it contains some very useful and important information. Then run it:

Note: At this point, you will get an auto-generated debug APK in the vlc-android/build/outputs/apk folder, signed with a debug key.

In order to build a non-debug (release, and unsigned) package:

Note: At this point, you will get an release APK in the same folder.

Build LibVLC

To build LibVLC, simply pass the -l option:

.aar archive will be located in libvlc/build/outputs/aar/

Gradle tweaks

To improve gradle execution time, try these options by writing this in gradle.properties in vlc android project. Or directly in your

Run it and enjoy!

Troubleshooting

Compilation error on Dependencies

Sometimes, especially when gradle dependencies have been upgraded, the compile.sh will fail to refetch dependencies. Just close Android Studio and re-run the script to fix this issue.

Debugging

Here are some helpful links if you wish to debug VLC on Android:

Native debugging

If you run VLC Android and you get a crash that looks something like this:

You have a native crash. To debug it, you need to have compiled VLC as above and installed it on your device. Once your compiled VLC build is on your device, you can find the backtrace as follows:

1. Make sure you are in the directory that you checked out VLC-Android in.
2. Migrate the libvlc folders. (Do this every time the code is recompiled)
   1. cp -r libvlc/jni vlc-android
   2. cp -r libvlc/libs vlc-android
   3. cp -r libvlc/obj vlc-android
   4. (This is because the libvlc and VLC for Android folders were split yet the debugger needs the object files from both.)
3. cd vlc-android
4. $ANDROID_NDK/ndk-gdb —verbose —force —start

At this point, lots of stuff will appear:

1. At this point, type in «continue» and press Enter.
2. Perform the actions you did to make it crash. It will spit out something like this:

1. Now, just type in «bt full» (excluding the quotation marks) and press Enter. That is your backtrace that you should give to the developers when they ask for it (possibly on a pastebin, too).

Troubleshooting

Outdated Awk

If you receive the error message while building:

The prebuilt version of Awk that comes with the Android NDK is outdated. Defining HOST_AWK in your environment does nothing as the system still tries to just the one that comes with the Android NDK. To get around this issue, simply rename or delete the Awk binary that comes with the Android NDK. For example to move it:

Can’t find Ant

If you’re new to Ant, please be aware that some Linux distributions don’t install it in the usual spot as with other programs. Try checking to see if the directory /usr/share/java/apache-ant/bin exists and add it to your path.

Outdated autotools-dev

If you get the following error message you may have have an outdated version of autotools-dev:

You may first want to check if your distribution has any available updates for this package. Alternatively, you can manually update your config.guess and config.sub files from here: [1]. These files are typically located in /usr/share/misc on Debian based distributions.

autoreconf: automake failed with exit status: 1

If you are using Automake 1.13 or higher, you must remove -Werror from vlc/contrib/android/gnutls/configure.ac to continue. (First reported in [2])

autoreconf: automake failed with exit status: 1

This error may occur when compiling with an older Linux distribution, such as Ubuntu 12.04, that doesn’t meet bootstrap prerequisites. As of 2014-08-09, the master branch for vlc-ports/android.git [3] lacks patch 5199 [4]. Without the patch, compile.sh builds out dated automake and autoconf that may not access libtool despite presence of a current libtool binary amongst supporting tools and a similar or more recent binary present as part of the OS.

To work around this error, patch the master branch or update the prerequisites. For Ubuntu 12.04, upgrade autoconf, automake, and cmake as dictated by vlc/extras/tools/bootstrap.

Can’t run aapt or adb on Linux 64-bit

You must install the 32-bit libraries of the following libraries, as the precompiled Google binaries depend on them: libc6, libstdc++6, and zlib.

New versions of Debian and/or Ubuntu require you to install i386 versions of packages:

If you are under old versions of Ubuntu, install ia32-libs can help you solve this issue.

Источник

Documentation:Android

Here is the documentation of the Android port of VLC media player.

Contents

Preliminary Notes

VLC for Android is a little different from VLC on desktops. In some ways, you can do more; in other ways, you can do less. VLC for Android only does media playback. Active streaming or file / stream to file conversations are not supported for usability and performance reasons. This walk-through does only include screenshots of a phone interface for size reasons. However, all features are also available on tablets with a similar appearance.

Feature Overview

Feature	Version 1.0	Version 1.6	Version 2.0	Version 2.5	Version 3.0	Version 3.1
Opening Network Streams	No	Yes	Yes	Yes	Yes	Yes
UPnP discovery and streaming	No	Yes	Yes	Yes	Yes	Yes
Plex server discovery and streaming	No	Yes	Yes	Yes	Yes	Yes
Password-protected Plex shares	No	No	No	No	No	No
Downloads from UPnP multimedia servers	No	No	No	No	No	No
FTP discovery, streaming	No	Yes	Yes	Yes	Yes	Yes
Store FTP server bookmarks	No	No	No	Yes	Yes	Yes
Audio Playback via Connector Cables	Yes	Yes	Yes	Yes	Yes	Yes
Video Playback via Connector Cables	Yes	Yes	Yes	Yes	Yes	Yes
Subtitles playback	Yes	Yes	Yes	Yes	Yes	Yes
Subtitles Font Customization	No	No	Yes	Yes	Yes	Yes
Closed Caption playback	Yes	Yes	Yes	Yes	Yes	Yes
Teletext subtitles playback	No	No	Yes	Yes	Yes	Yes
Multi-track audio handling	No	Yes	Yes	Yes	Yes	Yes
Video Filtering incl. Screen Brightness	No	No	No	No	No	No
Video Cropping and Aspect Ratio variation	Yes	Yes	Yes	Yes	Yes	Yes
Deinterlacing	Yes	Yes	Yes	Yes	Yes	Yes
Playback Speed control	Yes	Yes	Yes	Yes	Yes	Yes
Audio/Subtitles delay control	No	No	Yes	Yes	Yes	Yes
Repeated playback	Yes	Yes	Yes	Yes	Yes	Yes
Gestures based playback control	Yes	Yes	Yes	Yes	Yes	Yes
Playback of Audio-only media (mp3, m4a, flac, …)	Yes	Yes	Yes	Yes	Yes	Yes
Audio Playback in Background	Yes	Yes	Yes	Yes	Yes	Yes
Video Playback in Background	Yes	Yes	Yes	Yes	Yes	Yes
Playback timer	Yes	Yes	Yes	Yes	Yes	Yes
Chapter & title selection	No	No	Yes	Yes	Yes	Yes
10-band equalizer	Yes	Yes	Yes	Yes	Yes	Yes
Playback UI Lock	Yes	Yes	Yes	Yes	Yes	Yes
Smart Media Library sorting for audio albums and TV shows	Yes	Yes	Yes	Yes	Yes	Yes
Media Library Search	No	Yes	Yes	Yes	Yes	Yes
Passcode Lock	No	No	No	No	No	No
Voice search support	No	No	No	Yes	Yes	Yes
Voice actions support	No	No	No	No	No	No
Organize media in folders	No	No	No	No	No	No
Use folders as playlists	No	No	Yes	Yes	Yes	Yes
Loop playlists	Yes	Yes	Yes	Yes	Yes	Yes
Playback control through headphones or lock screen	Yes	Yes	Yes	Yes	Yes	Yes
Mediasession support (Wear, TV, etc…)	No	No	Partial	Yes	Yes	Yes
Playback is paused when headphones are unplugged	Yes	Yes	Yes	Yes	Yes	Yes
WiFi upload and HTTP downloads in background	No	No	No	No	No	No
Support for password protected HTTP streams	No	No	No	No	No	No
Sharing files with further apps	No	No	No	No	No	No
Custom vlc:// protocol	No	No	Yes	Yes	Yes	Yes
Support for x-callback-url	No	No	No	No	No	Yes
Action mode	No	No	No	Yes	Yes	Yes
Android TV	No	Yes	Yes	Yes	Yes	Yes
Picture-in-Picture	No	No	Partial	Yes	Yes	Yes
ChromeOS support	No	ARC	ARC	Yes	Yes	Yes
Android Auto	No	No	No	Yes	No	Yes
Sorting	No	No	Partial	Yes	Yes	Yes
360° videos	No	No	No	Yes	Yes	Yes
DayNight mode	No	No	No	Yes	Yes	Yes
Chromecast	No	No	No	No	Yes	Yes
Equalizer custom presets	No	No	No	No	Yes	Yes
Audio boost	No	No	No	No	Yes	Yes
Android 2.1 support	Yes	Yes	No	No	No	No
Android 2.2 support	Yes	Yes	Yes	No	No	No
Android 2.3 support	Yes	Yes	Yes	Yes	Yes	No
Android 6 (Runtime permissions)	No	No	Yes	Yes	Yes	Yes
Android 8 support	No	No	No	Partial	Partial	Yes

Installation

There are many ways to install VLC on Android. This may be because you have a non-ARMv7 or x86 processor or do not wish to use the Play Store for whatever reason.

From the Play Store (recommended)

The normal way, for ARMv7 (and above) and x86 processors only. Don’t know your processor? Don’t worry, if you can download it, you have a compatible ARMv7 or an x86 processor.

From the F-Droid Repository

The F-Droid repository (https://f-droid.org) is a completely FOSS (Free and Open Source Software) equivalent to the Google Play Store. The F-Droid Repository and all apps within it are provided completely free of charge and licensed under open source licenses. The F-Droid repository can be downloaded directly from their website. The «Unknown Sources» setting must be turned on for Android devices (typically located in Settings -> Security) in order to install repositories other than the Google Play Store.

From VideoLAN

If you can’t download from the Play Store or just want to install the VLC .apk by yourself, follow these steps:

1. Go to Android Settings → Security → Device Administration → Enable ‘Unknown Sources’
2. Go to our download server, preferably from your device: http://get.videolan.org/vlc-android/2.0.6/
3. Choose your processor architecture (ARMv7 or Intel x86) and grab the .apk file.
4. Click on the .apk you just downloaded and install it.

Don’t really know your processor architecture? Try both. it’s not very clever, but it’s harmless.

None of the two work? It is possible that you have an older processor with the ARMv6 architecture. The solution for now is to install a Nightly Build release. See below.

Still doesn’t work? Really? Well, then you must have an exotic processor. Contact us, on the Android forum or directly at android-support@videolan.org.

Be a Beta tester or try a Beta release

You want want to know the future of VLC for Android? You want to help us and/or test if your issue is already fixed for the next release ?

Be a Beta tester

Just follow this link Be a Beta tester

Soon, Beta release will automatically install on our device.

Try a Beta release

You don’t want to be a Beta Tester but just try a Beta ? Follow these steps :

1. Go to Android Settings → Security → Device Administration → Enable ‘Unknown Sources’
2. Go to our server, preferably from your device, : http://get.videolan.org/testing/android/2.1.13/
3. Choose your processor architecture (ARMv7, ARMv8, x86. )
   Don’t really know your processor architecture? Try both. it’s not very clever, but it’s harmless
4. Download the chosen .apk on your device
5. Click on the .apk you just download and install it.

Install a Nightly Build

You fear nothing and want our very last works on VLC ? Or you have an ARMv6 Processor and want VLC? Follow these steps:

1. Go to Android Settings → Security → Device Administration → Enable ‘Unknown Sources’
2. Go to our server, preferably from your device: http://nightlies.videolan.org/
3. Choose your processor architecture (ARMv7, ARMv8, x86. )
4. Grab the latest .apk
5. Click on the .apk you just download and install it.

You may experience some weird issues but generally, it works fine. If not, please try an older nightly release, and contact us.

Interface

At first start, VLC scans all your device to find all your media files. This is the main interface after the scan :

Show Menu Video view Audio view Directory view History view

Video browser view Search a specific media Open network MRL Load last playlist More actions : Sort by name or length Refresh your media library Equalizer Preferences About VLC

Playing Video

Video browser view

This view displays all your videos present in your device, or in the directories you have specified (see Preferences). To play one, just click on it, like the video .

Note the difference with the video which is a group of videos : VLC automatically groups your videos with the 4 same starting letters.

A Video A group of videos.

Video playback interface

Video title Battery and time Play / Pause Aspect ratio Audio tracks Subtitles tracks

Video menu (for DVD iso) Lock screen Elapsed time Seek bar Total time / Remaining time Advanced Options Playback Speed Sleep timer Jump to specific time Add subtitle

• You can change audio and/or subtitle track if there are any. If not, these icons won’t be displayed.
• The Video Menu icon is only displayed for iso video (a DVD iso for example)

Источник