recloudstream / recloudstream/cloudstream

💡Feature Request: Provide Alternative APK Using VLC Instead of Media3

Open
#1,776 2 comments 4 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
Kotlin
Stars
10.7k
Forks
1.1k
Avg merge
1d 23h
Merged PRs (30d)
15

Description

Describe your suggested feature

First of all, thank you for the awesome work on Cloudstream. I would like to suggest releasing a second APK (optional build) that uses the VLC player library instead of the default androidx.media3 (ExoPlayer). This would allow users to choose between the two depending on their needs and device compatibility.

Why this is useful:

Media3 (ExoPlayer) is lightweight and integrates well with the Android ecosystem but may have limitations with certain codecs or streaming formats.

VLC has wider codec support, better handling of some stream types, and includes features like subtitle rendering and hardware/software decoding options.

Suggested Approach:

Keep the current APK using androidx.media3 as the default.

Release an optional secondary APK (e.g., cloudstream-vlc.apk) which includes VLC as the playback engine.

Other details

Additional Notes:

This approach gives users flexibility without impacting the main app release. VLC already has an Android library that could be used with some conditional logic or flavor-based builds.

Thanks for considering this!

Acknowledgements
  • My suggestion is NOT about adding a new provider
  • I have searched the existing issues and this is a new ticket, NOT a duplicate or related to another open issue.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

No files or tests are named. Start by reviewing the Android build configuration and the current Media3 playback integration, then assess how a flavor-based build could include the VLC Android library. Done means a separately releasable VLC APK exists without changing the default Media3 APK.

Written by the indexing model from the issue text.

Assessment

Tech stack
android, kotlin
Domain
mobile
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.