{"id":13428910,"url":"https://github.com/videolan/vlc-android","last_synced_at":"2025-05-13T20:10:21.482Z","repository":{"id":37406018,"uuid":"123426934","full_name":"videolan/vlc-android","owner":"videolan","description":"  VLC for Android, Android TV and ChromeOS","archived":false,"fork":false,"pushed_at":"2025-05-05T15:03:08.000Z","size":68184,"stargazers_count":3046,"open_issues_count":5,"forks_count":670,"subscribers_count":77,"default_branch":"master","last_synced_at":"2025-05-05T16:23:45.478Z","etag":null,"topics":["android","libvlc","multimedia","player","videolan","vlc"],"latest_commit_sha":null,"homepage":null,"language":"Kotlin","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/videolan.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-03-01T11:37:03.000Z","updated_at":"2025-05-05T15:03:13.000Z","dependencies_parsed_at":"2024-06-18T07:44:38.905Z","dependency_job_id":"d937c4bd-5952-4f8c-aa84-8a573348d374","html_url":"https://github.com/videolan/vlc-android","commit_stats":{"total_commits":17559,"total_committers":246,"mean_commits":71.3780487804878,"dds":0.6822711999544393,"last_synced_commit":"5821fab251c06b78241037788f1a3fc86aa8d985"},"previous_names":[],"tags_count":423,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/videolan%2Fvlc-android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/videolan%2Fvlc-android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/videolan%2Fvlc-android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/videolan%2Fvlc-android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/videolan","download_url":"https://codeload.github.com/videolan/vlc-android/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254020607,"owners_count":22000753,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","libvlc","multimedia","player","videolan","vlc"],"created_at":"2024-07-31T01:01:08.552Z","updated_at":"2025-05-13T20:10:21.465Z","avatar_url":"https://github.com/videolan.png","language":"Kotlin","funding_links":[],"categories":["Applications","Kotlin","Android Apps","Players \u0026 Clients","🚀 The Applications","Apps"],"sub_categories":["Android Media","CMAF \u0026 fMP4 Packaging","9. VLC","Media Player"],"readme":"# VLC for Android\n\nThis is the official **Android** port of [VLC](https://videolan.org/vlc/).\n\nVLC on Android plays all the same files as the classical version of VLC, and features a media database\nfor Audio and Video files and stream.\n\n- [Project Structure](#project-structure)\n- [LibVLC](#libvlc)\n- [License](#license)\n- [Build](#build)\n  - [Build Application](#build-application)\n  - [Build LibVLC](#build-libvlc)\n- [Contribute](#contribute)\n  - [Pull requests](#pull-requests)\n  - [Translations](#translations)\n- [Issues and feature requests](#issues-and-feature-requests)\n- [Support](#support)\n\n## Project Structure\n\nHere are the current folders of vlc-android project:\n\n- extension-api : Application extensions SDK (not released yet)\n- application : Android application source code, organized by modules.\n- buildsystem : Build scripts, CI and maven publication configuration\n- libvlc : LibVLC gradle module, VLC source code will be cloned in `vlc/` at root level.\n- medialibrary : Medialibrary gradle module\n\n## LibVLC\n\nLibVLC is the Android library embedding VLC engine, which provides a lot of multimedia features, like:\n\n- Play every media file formats, every codec and every streaming protocols\n- Hardware and efficient decoding on every platform, up to 8K\n- Network browsing for distant filesystems (SMB, FTP, SFTP, NFS...) and servers (UPnP, DLNA)\n- Playback of Audio CD, DVD and Bluray with menu navigation\n- Support for HDR, including tonemapping for SDR streams\n- Audio passthrough with SPDIF and HDMI, including for Audio HD codecs, like DD+, TrueHD or DTS-HD\n- Support for video and audio filters\n- Support for 360 video and 3D audio playback, including Ambisonics\n- Ability to cast and stream to distant renderers, like Chromecast and UPnP renderers.\n\nAnd more.\n\n![LibVLC stack](https://images.videolan.org/images/libvlc_stack.png)\n\nYou can use our LibVLC module to power your own Android media player.\nDownload the `.aar` directly from [Maven](https://search.maven.org/artifact/org.videolan.android/libvlc-all) or build from source.\n\nHave a look at our [sample codes](https://code.videolan.org/videolan/libvlc-android-samples).\n\n## License\n\nVLC for Android is licensed under [GPLv2 (or later)](COPYING). Android libraries make this, de facto, a GPLv3 application.\n\nVLC engine *(LibVLC)* for Android is licensed under [LGPLv2](libvlc/COPYING.LIB).\n\n## Build\n\nNative libraries are published on bintray. So you can:\n\n- Build the application and get libraries via gradle dependencies (JVM build only)\n- Build the whole app (LibVLC + Medialibrary + Application)\n- Build LibVLC only, and get an .aar package\n\n### Build Application\n\nVLC-Android build relies on gradle build modes :\n\n- `Release` \u0026 `Debug` will get LibVLC and Medialibrary from Bintray, and build application source code only.\n- `SignedRelease` also, but it will allow you to sign application apk with a local keystore.\n- `Dev` will build build LibVLC, Medialibrary, and then build the application with these binaries. (via build scripts only)\n\n### Build LibVLC\n\nYou will need a recent Linux distribution to build VLC.\nIt should work with Windows 10, and macOS, but there is no official support for this.\n\n#### Setup\n\nCheck our [AndroidCompile wiki page](https://wiki.videolan.org/AndroidCompile/), especially for build dependencies.\n\nHere are the essential points:\n\nOn Debian/Ubuntu, install the required dependencies:\n```bash\nsudo apt install automake ant autopoint cmake build-essential libtool-bin \\\n    patch pkg-config protobuf-compiler ragel subversion unzip git \\\n    openjdk-8-jre openjdk-8-jdk flex python wget\n```\n\nSetup the build environment:\nSet `$ANDROID_SDK` to point to your Android SDK directory\n`export ANDROID_SDK=/path/to/android-sdk`\n\nSet `$ANDROID_NDK` to point to your Android NDK directory\n`export ANDROID_NDK=/path/to/android-ndk`\n\nThen, you are ready to build!\n\n#### Build\n\n`buildsystem/compile.sh -l -a \u003cABI\u003e`\n\nABI can be `arm`, `arm64`, `x86`, `x86_64` or `all` for a multi-abis build\n\nYou can do a library release build with `-r` argument\n\n#### Medialibrary\n\nBuild Medialibrary with `-ml` instead of `-l`\n\n## Contribute\n\nVLC is a libre and open source project, we welcome all contributions.\n\nJust respect our [Code of Conduct](https://wiki.videolan.org/CoC/), 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.\n\n\n### Pull requests\n\nPull requests must be proposed on our [gitlab server](https://code.videolan.org/videolan/vlc-android/).\n\nSo you must create an account, fork vlc-android project, and propose your merge requests from it.\n\n**Except for translations**, see the section below.\n\n### Translations\n\nYou can help improving translations too by joining the [transifex vlc project](https://www.transifex.com/yaron/vlc-trans/dashboard/)\n\nTranslations merge requests are then generated from transifex work.\n\n## Issues and feature requests\n\nVLC for Android bugtracker is hosted on [VideoLAN gitlab](https://code.videolan.org/videolan/vlc-android/issues)  \nPlease look for existing issues and provide as much useful details as you can (e.g. vlc app version, device and Android version).\n\nA template is provided, please use it!\n\nIssues without relevant information will be ignored, we cannot help in this case.\n\n## Support\n\n- For usage support, use the in-app feedback option in the `About` screen\n- Android mailing list: android@videolan.org\n- bugtracker: https://code.videolan.org/videolan/vlc-android/issues\n- IRC: *#videolan* channel on [libera](https://libera.chat/)\n- VideoLAN forum: https://forum.videolan.org/viewforum.php?f=35\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvideolan%2Fvlc-android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvideolan%2Fvlc-android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvideolan%2Fvlc-android/lists"}