31 repositories · 20+ languages
CloudStream Repositories & Extensions — Full List and Setup Guide
Table of Contents
ShowHide
What is a CloudStream repository?
A repository is a list. That is genuinely all it is.
- It is a single JSON file hosted on GitHub, Codeberg, GitLab or a paste service.
- It contains no video, no media and no content of any kind.
- All it says is: these extensions exist, here is where to fetch each one, here is the version number.
When you add a repository to CloudStream, you are adding a catalogue you can browse. Nothing is downloaded or activated until you install an individual extension from it.
Why the app works this way:
- The core app stays small, because the content layer is optional.
- Anyone can publish a repository without needing the app updated.
- You choose which sources exist in your app instead of accepting a list someone else picked.
- If a repository goes down, only that catalogue disappears. The app keeps working.
Repository vs extension vs provider
These three words get used interchangeably online, which is where most beginner confusion comes from. They are not the same thing.
| Term | What it is | Analogy |
|---|---|---|
| Repository | A list of available extensions | A shop’s catalogue |
| Extension | One installable module from that list | One item in the catalogue |
| Provider | An installed extension, as it appears in the app | The item now on your shelf |
| Source | The website the extension reads | Where the item came from |
In practice:
- You add a repository once.
- You install several extensions from it.
- Each installed extension shows up as a provider in your home screen selector.
- Each provider talks to its own source website.
“Plugin” is another word for extension. Both are used in the app and in community discussion.
How to add a repository
You can add one two ways. The shortcode method is faster and removes typing mistakes entirely.
The steps
- Open CloudStream and tap the Settings icon.
- Tap Extensions.
- Tap Add repository — the floating button at the bottom right.
- Enter a name (optional, just for your own reference).
- Paste the URL, or type the short shortcode.
- Tap Add repository.
- A warning appears explaining that third-party extensions are not checked by the CloudStream team. Read it, then tap Open repository.
- The extension list loads.
Shortcode or full URL?
| Shortcode | Full URL | |
|---|---|---|
| Length | A few characters | Very long |
| Typing on a TV remote | Easy | Painful |
| Risk of typos | Almost none | High |
| Works offline from memory | Yes | No |
On Android TV and Firestick, always use the shortcode. Typing a raw GitHub link with a directional remote is a genuinely miserable experience.
If nothing loads, jump to repository problems below.
How to install extensions
Adding a repository does not install anything. You still have to pick extensions from it.
- Browse or search the repository’s extension list.
- Tap the download icon next to any extension you want.
- Installed extensions show a checkmark or an uninstall icon.
- Go back to the home screen.
- The floating button that said None now lists your installed providers.
- Tap one to browse it.
Turn on automatic updates
- Go to Settings → Extensions.
- Enable automatic extension updates.
- The app then refreshes extensions on launch.
This single setting prevents most “nothing is loading” problems. Extensions break when source websites change, and the fix usually arrives as an extension update within days.
Full repository list
Every entry below includes its shortcode. Type the shortcode into the Add repository box and the app expands it automatically.
Official and general purpose
| Repository | Focus | Shortcode | Maintainer |
|---|---|---|---|
| CloudStream Providers (Official) | General, English | cspr | recloudstream |
| Mega Repository | Large mixed catalogue | megarepo | self-similarity |
| Hexated | General | mwyw140i | codeberg cloudstream |
| doGior’s Had Enough | General | gior | doGior |
| Luna712 | General | luna712 | Luna712 |
| CuxPlug | General | CuxPlug | ycngmn |
| Horis | General | Owyw2lbO | codeberg cloudstream |
| Storm | General | Swyw03Nc | codeberg cloudstream |
Start here. The official repository is the safest first addition — it is maintained by the same community that builds the app.
English
| Repository | Focus | Shortcode | Maintainer |
|---|---|---|---|
| English (Codeberg) | English catalogue | 6wyw1RnS | codeberg cloudstream |
| Multilingual | International mix | Bwyw1S3k | codeberg cloudstream |
| CNC Verse | Multi-language | cncv | NivinCNC |
Anime
| Repository | Focus | Shortcode | Maintainer |
|---|---|---|---|
| Phisher Repo | Anime and Asian drama | phisherrepo | phisher98 |
| Crunchyroll | Anime | wwyw2e4x | codeberg cloudstream |
Anime sources change more often than any other category, so anime extensions break more often too. Install two rather than one. More detail: best CloudStream repos for anime.
Hindi and Indian
| Repository | Focus | Shortcode | Maintainer |
|---|---|---|---|
| Megix / CSX | Hindi and English | csx | SaurabhKaperwan |
| Likdev | Tamil | bwyw0Mcv | codeberg cloudstream |
Arabic
| Repository | Focus | Shortcode | Maintainer |
|---|---|---|---|
| Arabic | Arabic | Jwyw1ZiR | codeberg cloudstream |
| Arabico | Arabic | 0wF96Vs1 | community |
Turkish
| Repository | Focus | Shortcode | Maintainer |
|---|---|---|---|
| Kekik Akademi | Turkish | KekikAkademi | keyiflerolsun |
| Kraptor | Turkish | kraptorcs | Kraptor123 |
| DiziPal & TabiiSpor | Turkish, sports | sarapcanagii | sarapcanagii |
Turkish repositories are among the most actively maintained in the whole ecosystem.
European languages
| Repository | Focus | Shortcode | Maintainer |
|---|---|---|---|
| Italian Providers | Italian | ipr | Gian-Fr |
| German Providers | German | gpr | Bnyro |
| French | French | jwyw2fJc | codeberg cloudstream |
| FStream | French | fstream | community |
| Avocado | Spanish | aguaco | community |
| CakesTwix | Ukrainian | cakes | CakesTwix |
Other regional
| Repository | Focus | Shortcode | Maintainer |
|---|---|---|---|
| IndoStream | Indonesian | indos | TeKuma25 |
| CloudStream Vietnamese | Vietnamese | viet | GitLab: tearrs |
| Redowan’s BDIX | Bangladeshi / BDIX | redowan | redowan99 |
| Saimuel | Portuguese / Brazil | saim | saimuelbr |
A note on this list. Repositories are volunteer projects that appear, move and go quiet without notice. We re-test this list monthly, but between checks some entries will inevitably stop responding. If one fails, that is the repository, not your app.
Which repositories should you install?
This is the question the big CloudStream sites never answer. They publish a list of thirty and leave you to guess.
Here is the honest advice: pick two or three, not thirty. Below are starting points by what you actually watch.
If you mostly watch English films and series
- Official CloudStream Providers (cspr)
- Mega Repository (megarepo)
- That is enough. Add a third only if you find gaps.
If you are here for anime
- Phisher Repo (phisherrepo)
- Official CloudStream Providers (cspr) as a fallback
- Then connect your anime tracker so progress syncs: tracker sync guide
If you watch Hindi or Indian content
- Megix / CSX (csx)
- Official CloudStream Providers (cspr)
If you watch in Arabic, Turkish, Indonesian or a European language
- One repository for your language
- One general repository as a backup
- Language-specific repos usually beat general ones for regional catalogues
If you are setting up an Android TV box or Firestick
- Two repositories maximum
- These devices have limited memory, and every extra provider slows global search
- Use shortcodes, not URLs
If you have no idea where to start
- Add cspr only.
- Use it for a week.
- Add a second repository when you hit an actual gap, not before.
How to tell if a repository is dead
Before you spend an hour troubleshooting “the app is broken”, check whether the repository behind it still exists. This takes a minute.
Signs a repository has gone quiet
- The extension list loads but every provider returns nothing.
- The repository fails to add at all, with no error explanation.
- Extensions have not shown an available update in several months.
- The same provider fails across different titles and different categories.
How to check properly
- Open the repository’s source page in a browser — GitHub, Codeberg or GitLab.
- Look at the date of the most recent commit.
- Within 3 months — actively maintained.
- 3 to 6 months — slowing down, expect some broken providers.
- Over a year — treat it as dead.
- Check whether the project has been archived. GitHub shows an archived banner.
- Check the open issues. Lots of unanswered “not working” reports is a clear signal.
What to do about a dead repository
- Remove it. A dead repo still gets queried during global search, and the app waits for it to time out.
- Replace it with an active one covering the same language or category.
- Do not stack more repositories on top hoping one works. That makes searches slower, not better.
How many repositories is too many?
More is not better. This is the most common mistake new users make.
What happens when you add too many
- Global search gets slower. The app queries every installed provider and waits for each to respond, including dead ones.
- Results get messy. The same title appears ten times from ten sources, in three languages.
- Link resolution slows down. More providers means more places to check before playback starts.
- Low-memory devices struggle. TV boxes and older phones can crash outright.
- Updates take longer. Every repository is checked on launch.
A sensible ceiling
| Device | Recommended | Maximum |
|---|---|---|
| Modern phone | 2–4 repositories | 6 |
| Older phone | 2 repositories | 3 |
| Android TV box | 2 repositories | 3 |
| Firestick (older models) | 1–2 repositories | 2 |
The better lever is provider priority, not quantity. Rank your most reliable providers at the top and link resolution speeds up noticeably: source priority guide.
Updating and removing repositories
Updating extensions
- Go to Settings → Extensions.
- Tap Update all, or update individual extensions.
- Turn on automatic updates so this happens on launch.
Removing a single extension
- Open the repository in Settings → Extensions.
- Tap the uninstall icon beside the extension.
Removing an entire repository
- Go to Settings → Extensions.
- Long-press or use the menu beside the repository name.
- Choose Remove.
- Removing a repository does not automatically remove extensions you already installed from it — uninstall those separately.
After an app update
- Extensions can reset when the plugin system changes between major versions.
- Your repositories stay listed, so just reinstall the extensions from them.
- A backup makes this painless.
Repository safety — what you are trusting
This deserves a straight answer rather than a reassuring one.
What the app itself does
- CloudStream shows a warning before you open any third-party repository. That warning is not a formality.
- The core team does not review, vet or approve community repositories.
- The app has no way to verify what an extension does before you install it.
What you are actually trusting
- The person maintaining the repository.
- The code inside each extension you install.
- The source websites those extensions connect to.
How to reduce your risk
- Prefer the official repository where it covers what you need.
- Prefer repositories with a public source page you can inspect — GitHub or Codeberg, not an anonymous paste link.
- Prefer repositories that are actively discussed in the community. A repo nobody talks about is a repo nobody has checked.
- Install fewer extensions. Every one you add is additional third-party code.
- Be sceptical of a repository that appeared last week and promises everything.
On legality
Repositories are indexes, and indexes are not the issue. What matters is what each extension connects to. Some point at services that distribute with permission — public-domain archives, free ad-supported services, official APIs. Others do not. The app does not distinguish between them, and neither do we. Copyright rules differ by country, and you are responsible for what you install and watch. More detail: is CloudStream legal?
Repository problems and fixes
The repository will not add
- Make sure the URL points to the raw JSON file, not a web page. Raw links contain raw.githubusercontent.com or /raw/.
- Use the shortcode instead — it removes typing errors completely.
- Open the URL in a browser to confirm the host is up and the file still exists.
- Some networks and DNS providers block GitHub raw content. Switch from Wi-Fi to mobile data to test.
The repository adds but the extension list is empty
- The repository is probably dead or has moved.
- Check its source page for recent activity.
- Remove it and use an active alternative.
Extensions install but return no results
- Update all extensions first. This fixes most cases.
- Try a different provider for the same title.
- The source website may be down or blocked in your region.
- Full guide: no links found fix
Extensions vanished after updating the app
- Plugin system changes between major versions can reset them.
- Your repositories are still listed — reinstall the extensions.
- Full guide: extensions disappeared fix
Search became very slow
- You have too many repositories or too many dead providers.
- Remove anything that has been failing for weeks.
- Set provider priority so reliable sources are checked first.
A shortcode does not work
- Shortcodes are case-sensitive. Type them exactly as listed.
- If it still fails, the repository behind it has probably moved or shut down.
Frequently asked questions
What is a CloudStream repository?
A JSON file listing available extensions. It holds no media itself — it is only an index.
What is the difference between a repository and an extension?
A repository is the list. An extension is one item from that list. You add repositories, then install extensions from them.
How do I add a repository?
Settings → Extensions → Add repository, then paste a URL or type a shortcode.
What is a shortcode?
A short alias that stands in for a long repository URL. Much easier to type, especially on a TV remote.
Which repository should I add first?
The official one, cspr. It is maintained by the same community that builds the app.
How many repositories should I install?
Two to four on a phone. One or two on a TV box. More makes search slower and messier, not better.
Why does my repository show no extensions?
It has most likely gone inactive or moved. Check its source page for recent commits.
Are CloudStream repositories safe?
The app does not vet them. Prefer the official repository, prefer ones with a public source page you can inspect, and install as few extensions as you actually need.
Why do extensions keep breaking?
Each extension reads one specific website. When that website changes its layout, the extension stops working until a volunteer updates it.
Do repositories host movies?
No. They contain no media at all. They are lists of extensions, nothing more.
Can I make my own repository?
Yes. The format is documented publicly in the recloudstream project on GitHub.
Do I need to remove a repository before adding another?
No. You can have several at once, but keep the number small.
Why is my search so slow?
Too many installed providers, especially dead ones. The app waits for each to time out. Remove the ones that have stopped working.
Are repository shortcodes case-sensitive?
Yes. Type them exactly as written.
What happens if a repository shuts down?
Its catalogue disappears from your app. Extensions you already installed may keep working for a while, but will not receive updates.