An unofficial fork of CloudStream with built-in debrid support (Torrin, TorBox & Real-Debrid).
⚠️ Legal notice: This project is a fork of recloudstream/cloudstream, which is licensed under the GNU General Public License v3.0 (GPL-3.0). The GPL license file is preserved in this repository (LICENSE). All original copyright belongs to the CloudStream authors and contributors. All modifications made in this fork are released under the same GPL-3.0 license.
⚠️ By default, the app doesn't provide any video sources; you have to install extensions to add functionality. This project does not host, stream, or provide any copyrighted media — playback is resolved through the user's own Torrin/TorBox/Real-Debrid accounts, and content sources come from community extensions.
⚠️ First-launch disclaimer: On first launch the app presents a legal disclaimer that must be accepted before use. It explains that the app does not host content, that users are responsible for complying with their local laws, and that all content comes from third-party extensions. Declining exits the app.
- Torrin debrid integration (app core): magnet links from any extension are resolved through your Torrin account into direct, signed HTTPS streams (no local torrent engine needed). Settings → Player → Debrid.
- TorBox debrid integration (app core): same flow for TorBox. Falls back Torrin → TorBox → local torrent automatically.
- Real-Debrid debrid integration (app core): same flow for Real-Debrid. Full support for magnet submission, file selection, and link unrestricting.
- Parallel debrid resolution: when multiple debrid services are enabled, they run in parallel and use the first successful result for faster stream resolution.
- Smart caching: in-memory cache with 2-hour TTL avoids repeated API calls for the same content, significantly improving performance.
- Retry logic with exponential backoff: automatic retry (3 attempts) for transient API failures with exponential backoff (1s, 2s, 4s) for reliable operation.
- Debug logging: centralized logging system with preference toggle (Settings → Player → Debrid → Debug logging) to monitor debrid operations.
- Test connection buttons: verify your API credentials for Torrin, TorBox, and Real-Debrid directly from settings before use.
- Per-link debrid choice: extensions can tag a magnet link with a debrid preference — links appear as "• Torrin • …" and "• TorBox • …" variants, the app tries the chosen debrid first and falls back to the other, so you pick which debrid plays each title.
- Plugins live in their own repository: cloudstream-extend-plugins — the Torrin, HiAnime, AniKoto, AnimeCube, HDHub4u, BollyFlix and YTS extensions are maintained and released separately so they can be updated independently of the app. Install them from Settings → Extensions → Add repository; see that repo for the URLs and for how to build them.
- User-configurable TMDB API key: Settings → Player → Metadata — supply your own free TMDB key (get one at themoviedb.org). The plugins require this key to fetch metadata (plot, posters, trending rows); without it, metadata enrichment is gracefully skipped.
- User-configurable TMDB region and language: Settings → Player → Metadata — choose your region (e.g., India, United States) and language (e.g., Hindi, English) to get localized content, trending movies/shows, and metadata in your preferred language.
- Download manager: download content for offline viewing with configurable parallel downloads, Wi-Fi-only mode, quality preference, and auto-delete after watching. Settings → Player → Downloads.
- Enhanced subtitle support: auto-download subtitles from OpenSubtitles for downloaded content, with configurable language, size, color, outline, font, and sync offset. Settings → Player → Subtitles.
The extensions are not part of this repository — they live in cloudstream-extend-plugins and are installed from there, so a plugin can be updated without touching the app. Settings → Extensions → Add repository, then paste the URL for the plugin you want (one repository per plugin, so you only install what you use):
| Plugin | Repository URL | Needs |
|---|---|---|
| Torrin | https://raw.githubusercontent.com/sandeep1027/cloudstream-extend-plugins/main/plugins/torrin/repo/repository.json |
debrid + TMDB key |
| Torrin MDBList | https://raw.githubusercontent.com/sandeep1027/cloudstream-extend-plugins/main/plugins/torrin-mdblist/repo/repository.json |
debrid + TMDB + MDBList key |
| Torrin Trakt | https://raw.githubusercontent.com/sandeep1027/cloudstream-extend-plugins/main/plugins/torrin-trakt/repo/repository.json |
debrid + TMDB + Trakt id |
| HiAnime | https://raw.githubusercontent.com/sandeep1027/cloudstream-extend-plugins/main/plugins/hianime/repo/repository.json |
nothing |
| AniKoto | https://raw.githubusercontent.com/sandeep1027/cloudstream-extend-plugins/main/plugins/anikoto/repo/repository.json |
nothing |
| AnimeCube | https://raw.githubusercontent.com/sandeep1027/cloudstream-extend-plugins/main/plugins/animecube/repo/repository.json |
nothing |
| HDHub4u | https://raw.githubusercontent.com/sandeep1027/cloudstream-extend-plugins/main/plugins/hdhub4u/repo/repository.json |
nothing |
| BollyFlix | https://raw.githubusercontent.com/sandeep1027/cloudstream-extend-plugins/main/plugins/bollyflix/repo/repository.json |
a debrid account |
| YTS | https://raw.githubusercontent.com/sandeep1027/cloudstream-extend-plugins/main/plugins/yts/repo/repository.json |
a debrid account |
HiAnime, AniKoto, AnimeCube and HDHub4u stream directly and need no key. BollyFlix and YTS are catalogue/torrent sources — neither site serves video, so every link is a magnet resolved through your Torrin / TorBox / Real-Debrid account (Settings → Player → Debrid), which you need to enable for them to play. The Torrin plugins additionally want a free TMDB API key in Settings → Player → Metadata.
One extra step: the home screen only shows rows for ONE provider at a time. Tap the provider chip at the bottom of Home (it shows "None" by default) and pick the extension (e.g. "Torrin MDBList") — its rows then appear on Home.
The home screen also filters providers by content type, and only Movies and TV Series are selected by default. HiAnime, AniKoto and AnimeCube are anime-only, so enable the Anime chip at the top of Home (or pin the provider from the same chip dialog) to see their rows.
Plugin source, the built .cs3 packages and per-plugin build scripts are in
cloudstream-extend-plugins,
which builds against the CloudStream library module pulled in as a submodule.
Its README covers building a .cs3, publishing a release (binary + sha256 go
together — the app verifies every download) and testing on a device via
adb push … /sdcard/Cloudstream3/plugins/.
Prebuilt APKs are available on the Releases page.
- Original app: recloudstream/cloudstream (GPL-3.0) — all credit for the base application goes to the CloudStream team and its contributors.
- Fork & debrid integrations:
sandeep1027(this repository). - HiAnime / AniKoto / AnimeCube / HDHub4u extensions: ported to the CloudStream plugin API from the community provider scrapers by Spyou; the JavaScript originals are MIT licensed. Maintained in cloudstream-extend-plugins.
- Torrin API: torrin.app · TorBox API: torbox.app · Real-Debrid API: real-debrid.com · TMDB data: themoviedb.org (used per their API terms).
GPL-3.0 — see LICENSE. This fork is a derivative work of CloudStream and must be distributed under the same terms: keep this license, keep attribution, and publish source for any modifications (this repository is the source).
- About Us:
- Installation Steps:
- Contributing:
- Issues:
- Extension Development:
- Language Support:
- Further Sources
CloudStream is a media center that prioritizes and emphasizes complete freedom and flexibility for users and developers.
CloudStream is an extension-based multimedia player with tracking support. There are extensions to view videos from:
- Librevox (audio-books)
- Youtube
- Twitch
- iptv-org (A collection of publicly available IPTV (Internet Protocol television) channels from all over the world.)
- nginx
- And more...
Please don't create illegal extensions or use any that host any copyrighted media. For more details about our stance on the DMCA and EUCD, you can read about it on our organization: reCloudStream
Our documentation is unmaintained and open to contributions; therefore, apps and sources, extensions in recommended sources, and recommended apps are not officially moderated or endorsed by CloudStream; if you or another copyright owner identify an extension that breaches your copyright, please let us know.
- AdFree, No ads whatsoever
- No tracking/analytics
- Bookmarks
- Phone and TV support
- Chromecast
- Extension system for personal customization
Our documentation provides the steps to install and configure CloudStream for your streaming needs.
Getting Started With CloudStream:
We happily accept any contributions to our project. To find out where you can start contributing towards our project, please look at our issues tab
While we actively accept issues and pull requests, we do require you fill out an template for issues. These include the following:
- Bug Report Template:
- For bug reports, we want as much info as possible, including your downloaded version of CloudeStream, device and updated version (if possible, current API), expected behavior of the program, and the actual behavior that the program did, most importantly we require clear, reproducible steps of the bug. If your bug can't be reproduced, it is unlikely we'll work on your issue.
- Feature Request Template:
- Before adding a feature request, please check to see if a feature request already has been requested.
Further details on creating extensions for CloudStream are found in our documentation.
Guide: For Extension Developers
As well as providing clear install steps, our website includes a wide variety of other tools, such as:
- Troubleshooting
- Further CloudStream Repositories
- Set-Up for other devices, such as:
- And more...
Even if you can't contribute to the code or documentation, we always look for those who can contribute in translation and language support. Your contribution is exceptionally appreciated; you can check our translation from the figure below.
