CloudStream is an Android media aggregation application that streams and downloads movies, TV series, and anime via a plugin-based provider system. The app has no built-in content; all media sources are provided by community extensions implementing `MainAPI` and `ExtractorApi` interfaces. The architecture comprises a Kotlin Multiplatform library defining plugin APIs and an Android app with ExoPlayer/Media3 playback, download manager, sync with tracking services (MAL, AniList, Kitsu, Simkl, Trakt), multi-source subtitle fetching, Chromecast support, and adaptive phone/TV UI. Content acquisition relies on web scraping: over 100 built-in extractors parse video hosting sites, often using JavaScript deobfuscation (via a custom JS interpreter) and AES decryption. The plugin system supports repository-based distribution, versioning, and binary compatibility checks. While the codebase is actively maintained and demonstrates good engineering practices (MVVM, coroutines, custom adapters), many extractors are brittle due to external site dependencies, and some modules exhibit tight coupling and deprecated API usage.

This repository is the canonical community index for Cloudstream extension repositories. It maintains a JSON list of repo URLs (repos-db.json) and uses a Python CI script to validate each repository's manifest and every plugin it exposes. The validation fetches repo.json, asserts required fields (name, manifestVersion, pluginLists), then concurrently checks every plugin URL with HTTP requests, collecting failures across all repos and their plugin lists. If all checks pass, it generates list.md with custom cloudstreamrepo:// deep links and, on the default branch, publishes that markdown to a Rentry page via GitHub Actions. Architecturally it is a small batch validation utility rather than a running service: ci_check.py is the entry point, create_markdown.py provides output rendering, and a GitHub Actions workflow orchestrates execution on every push/PR and publishes the result. External dependencies are httpx for async HTTP and rentry (CI only) for publishing. It relies on the availability of dozens of third-party GitHub/GitLab-hosted repo.json files. Notable implementation details include a JSONC-compatible decoder that strips // comments, asynchronous fan-out with gathered exceptions to validate many URLs quickly, and structured error reporting. The code is simple and readable, but dependency versions are unpinned and the checkout action is outdated, which introduces moderate technical drift.