SkyStream

<div align="center"> <a href="https://github.com/akashdh11/skystream/releases"> <img src="https://img.shields.io/github/downloads/akashdh11/skystream/total?style=for-the-badge&color=1f6feb" /> </a> <a href="https://github.com/akashdh11/skystream/stargazers"> <img src="https://img.shields.io/github/stars/akashdh11/skystream?style=for-the-badge&color=f1c40f" /> </a> <a href="https://github.com/akashdh11/skystream/releases"> <img src="https://img.shields.io/github/v/release/akashdh11/skystream?style=for-the-badge&color=f39c12" /> </a> <a href="https://github.com/akashdh11/skystream/issues"> <img src="https://img.shields.io/github/issues/akashdh11/skystream?style=for-the-badge&color=e74c3c" /> </a> <a href="https://github.com/akashdh11/skystream/issues?q=is%3Aissue+is%3Aclosed"> <img src="https://img.shields.io/github/issues-search/akashdh11/skystream?query=is%3Aissue+is%3Aclosed&style=for-the-badge&color=2ecc71" /> </a> <a href="https://github.com/akashdh11/skystream/commits/main"> <img src="https://img.shields.io/github/last-commit/akashdh11/skystream?style=for-the-badge&color=17a2b8" /> </a> </div>

⚠️ Warning: By default, this app doesn't provide any video sources; you have to install extensions to add functionality to the app.

A new, cross-platform media streaming application inspired by CloudStream.

Note: This project is an independent application built with Flutter. While it supports similar extension formats, it is a simplified, modern re-imagining and is not a direct clone or fork of the official client.

Please don't create illegal extensions or use any that host any copyrighted media. This project does not condone copyright infringement.

Community

Join the discussion, get help, or find new extensions on our Telegram channel or Discord server:

<a href="https://t.me/+Ez5Vsv2pUUFjZmNl"> <img src="https://img.shields.io/badge/Telegram-Channel-blue?style=for-the-badge&logo=telegram"> </a> <br> <a href="https://discord.gg/73XGA8Mxn9"> <img src="https://invidget.switchblade.xyz/73XGA8Mxn9"> </a>

Overview

SkyStream is a modern, media streaming client. It draws inspiration from the versatile architecture of CloudStream but implements a custom, cross-platform JavaScript engine for extensions, enabling support for Android, iOS, and Desktop from a single codebase.

Built With

Screenshots

📱 Mobile

<p align="center"> <img src="screenshots/mobile/home.png" width="360" /> <img src="screenshots/mobile/discover.png" width="360" /> <img src="screenshots/mobile/details.png" width="360" /> <img src="screenshots/mobile/settings.png" width="360" /> </p>

📺 TV

<p align="center"> <img src="screenshots/tv/details_1.png" width="720" /> <img src="screenshots/tv/details_2.png" width="720" /> </p>

Supported Platforms

| Platform | Support | |:---------------|:------------------------:| | Android | ✅ | | Android TV | ✅ | | iOS | ✅ (Sideloading required) | | Windows | ✅ | | macOS | ✅ | | Linux | ✅ (Beta) |

✨ Key Features

| Feature | Description | | :--- | :--- | | 📺 Extensions System | Install custom JavaScript plugins to Scrape & Stream content from any source. | | 📂 Direct Playback | Instant zero-copy playback for Local Files (MP4/MKV) and Torrents/Magnet Links. | | 🔗 Network Streams | Play arbitrary video URLs (M3U8, MP4) directly from settings. | | ⏱️ Smart History | "Continue Watching" across all media types with robust progress tracking. | | ⚡ Performance | Optimized for 90Hz/120Hz displays, ensuring a buttery smooth experience. | | 🎨 Modern UI | Material 3 Design, Dynamic Colors, and responsive layouts for Phones, Tablets, and Desktop. |

📥 Installation

Download the latest version from the Releases Page.

🤖 Android / Android TV

1. Download the skystream-android-arm64-v8a-v1.5.0.apk (recommended for most modern phones) or skystream-android-armeabi-v7a-v1.5.0.apk (for TV) from Releases.
2. Open the file and tap Install.
   • Note: You may need to allow "Install form Unknown Sources" in your browser settings.
3. Open SkyStream and install extensions via Settings > Extensions.

🍏 iOS (Sideloading)

SkyStream is not on the App Store. You must sideload it using a computer.

Requirements:

• A Computer (Windows or macOS)
• Sideloadly (Free)
• iTunes (if on Windows)

Steps:

1. Download skystream-ios-unsigned.ipa from the Releases Page.
2. Open Sideloadly on your computer.
3. Connect your iPhone/iPad via USB.
4. Drag the .ipa file into the Sideloadly window.
5. Enter your Apple ID in the configured field.
6. Click Start.
7. Once finished, the app will appear on your home screen.
8. On your device, go to Settings > General > VPN & Device Management, tap your email, and select Trust.

💻 Windows / macOS

1. Download the appropriate zip file for your OS (skystream-windows.zip, skystream-macos.zip, etc.).
2. Extract the archive.
3. Run the executable (skystream.exe or skystream.app).
   • macOS Note: You may need to Right Click -> Open to bypass the "Unidentified Developer" warning.

🛠️ Build from Source

Extension Development

This app uses a custom JS runtime for extensions.

• See PLUGIN_DEVELOPMENT_GUIDE.md for a complete guide on packaging and releasing your plugins.

FAQ

<details> <summary><b>How do I install extensions?</b></summary> SkyStream uses `.sky` or `.js` extension files. You can install them by navigating to <b>Settings > Extensions > Add Repository</b> and entering a repository URL (e.g., using a shortcode). </details> <details> <summary><b>Where is the media stored?</b></summary> SkyStream is a streaming client and does not host any content. All media is streamed directly from the third-party extensions you install. </details>

Star History

Star History

<a href="https://www.star-history.com/#akashdh11/skystream&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=akashdh11/skystream&type=date&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=akashdh11/skystream&type=Date" /> <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=akashdh11/skystream&type=Date" /> </picture> </a>

Contributors

<a href="https://github.com/akashdh11/skystream/graphs/contributors"> <img src="https://contrib.rocks/image?repo=akashdh11/skystream" /> </a>

License

MIT