CloudStream: an ad-free Android media player that ships empty until you add extensions
Android app for streaming and downloading media.
At a glance
- What is it?
- CloudStream is a Kotlin, GPL-3.0 media player for Android whose entire content catalogue comes from extensions you install yourself. The tradeoff is explicit freedom plus an explicit risk: nothing you add is moderated or endorsed by the project, and the README itself says so.
- Who is it for?
- CloudStream suits someone who wants an ad-free, tracker-free player and is willing to vet every extension themselves, and it does not suit someone who wants a working catalogue the moment the app finishes installing. Before you commit, read the no-endorsement clause in the copyright note, decide whether you are comfortable sourcing from extensions the project does not moderate, and treat the pre-release tag as a moving target rather than a version you can pin.
- Can I use it commercially?
- Yes, with conditions. GPL-3.0 is a copyleft licence: if you distribute software that includes it, you must release that software's source code under the same licence. Running it internally without distributing it does not trigger that obligation.
- Is it still maintained?
- Yes. The repository last received commits 3 days ago.
- What is it written in?
- Mainly Kotlin, according to GitHub's language statistics.
Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.
Star history
- recloudstream/cloudstream11,311 ★ · +587
| Repository | 2026-09-22 | 2026-11-15 |
|---|---|---|
| recloudstream/cloudstream | 10.7k | 11.3k |
587 Stars in the last 54 days, measured from the daily GitHub snapshot. Compare with other projects
Editorial analysis
A fresh install has no sources, which the first warning in the README states outright
The warning that opens the README is unambiguous: by default, this app doesn't provide any video sources, and you have to install extensions to add functionality to the app. The binary you install is therefore a shell. Bookmarks, phone and TV support, Chromecast, and the advertised ad-free, no-tracking behavior all live in that shell, but there is nothing to play until you add something. The starting points named are Librevox for audio-books, Youtube, Twitch, iptv-org for publicly available IPTV channels, and nginx. What the app cannot do on its own is play a single stream, and the consequence for a new user is a first run that looks broken until the extension step actually happens.
Extensions decide what the player is, and the project does not vet them
CloudStream describes itself as an extension-based multimedia player with tracking support, and presents the extension system as a feature for personal customization. The catch sits in the copyright note. The documentation is described as unmaintained and open to contributions, which means apps and sources, the extensions in recommended sources, and recommended apps are not officially moderated or endorsed by CloudStream. The project does state a position on DMCA and EUCD, asks that no illegal extensions be created or used, and invites copyright owners to make contact. What nobody checks for you is the individual extension you install. Every source you add is your own vetting job, and the app's reputation is not a warranty.
Install steps are handed off to an external docs site, not to the repository
There is no build or install command anywhere in the README. Installation is a link: the documentation provides the steps to install and configure CloudStream for your streaming needs, pointing at recloudstream.github.io/csdocs. The only direct artifact in the repository is a pre-release APK link to app-prerelease-release.apk under the pre-release release. Setup guidance is also split by device, with separate pages for Android TV, Windows and Linux. The consequence for a reader is that the repository itself explains nothing about getting the app onto a device, or what the version numbering means once it is there. Anyone who wants the steps offline or in version-matched form has to look somewhere other than this codebase.
The source tree carries Android, desktop and shared modules side by side
The top-level entries show the shape of the tree: app/, desktopApp/, shared/, library/, docs/ and fastlane/, next to build.gradle.kts, settings.gradle.kts, gradle.properties, gradlew and gradlew.bat. jitpack.yml sits at the root, and discoverium.yml sits alongside them. Two things follow. The desktopApp/ and shared/ modules exist next to the Android app/ module, which lines up with the documented Windows and Linux setup pages and with the phone and TV support claim, so one repository covers more than a handset. And fastlane/ is present at the root. The README does not say which module owns the player core.
A bug that cannot be reproduced is one nobody will work on
Contributing routes through the issues tab, where issues and pull requests are taken but a template is required. The bug report template asks for your downloaded version of CloudStream, the device and its updated version including the current API where possible, the expected behavior, the actual behavior, and clear reproducible steps. The stated bar is blunt: if your bug can't be reproduced, it is unlikely we'll work on your issue. Feature requests go through a separate template whose first instruction is to check whether the same request already exists. Consequence for a contributor is that your report has to carry its environment with it. Since playback depends on third-party extensions, a missing device and API detail is often the gap between a fixable trace and a report that sits.
Release names track months, and the newest tag is a rolling pre-release
The releases are named after periods rather than sequenced tightly. v4.8.0 is the July Update, dated July 10, 2026. v4.7.0 is the March Update, dated March 29, 2026. The newest entry is a pre-release build dated October 28, 2026 under the tag pre-release, and the last push to the default branch, master, is dated November 1, 2026. The consequence is that the tag called pre-release is a moving target, not a fixed point in history. The download link in the README points into that same rolling tag, so two people following it on different days can end up with different binaries, and the version string on a device may not tell you which source state produced the behavior you are looking at.
The docs site and the translation platform sit outside the codebase
Two things live away from the repository and matter to anyone reading or helping. Translations run through a Weblate project at hosted.weblate.org/engage/cloudstream, and the README asks for translation and language support contributions from people who cannot contribute code. The wider toolset is external too: a website that includes Troubleshooting, a Further CloudStream Repositories page, and device setup for Android TV, Windows and Linux. Set against the note that the documentation is unmaintained and open to contributions, the shape is clear. The repository holds the app, while the knowledge lives on sites the project does not fully control. What you cannot get from the code alone is a current, version-matched setup guide.
Editorial conclusion
CloudStream suits someone who wants an ad-free, tracker-free player and is willing to vet every extension themselves, and it does not suit someone who wants a working catalogue the moment the app finishes installing. Before you commit, read the no-endorsement clause in the copyright note, decide whether you are comfortable sourcing from extensions the project does not moderate, and treat the pre-release tag as a moving target rather than a version you can pin.
Frequently asked questions
What does CloudStream do?
It is an extension-based multimedia player with tracking support for Android, listing AdFree behavior with no ads whatsoever, no tracking or analytics, bookmarks, phone and TV support, Chromecast, and an extension system for personal customization.
Is CloudStream free?
CloudStream is released under GPL-3.0 and advertises no ads whatsoever plus no tracking or analytics. The README does not state a price or name a paid tier, so the extension sources you supply are what carry any cost.
Is CloudStream safe?
The app advertises no tracking or analytics, but the copyright note says recommended sources and the extensions inside them are not officially moderated or endorsed by CloudStream, so safety of an individual source is yours to verify.
how to use cloudstream extensions
By default the app provides no video sources and you install extensions to add functionality, with Librevox, Youtube, Twitch, iptv-org and nginx named as starting points. A separate guide for extension developers is linked from the README.
how to install cloudstream on android tv
The README contains no install commands and instead links to the getting started documentation at recloudstream.github.io/csdocs, which carries a dedicated Android TV setup page. The only direct file it points to is a pre-release APK.
Official sources
Add this badge to your README
If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.
[](https://hysenlabs.com/projects/recloudstream-cloudstream)Star history chart for your README
[](https://hysenlabs.com/projects/recloudstream-cloudstream)Was this useful?