Skip to content

NivinCNC/skystream

 
 

Repository files navigation

SkyStream

⚠️ 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:


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

Flutter Dart Riverpod Hive

Screenshots

πŸ“± Mobile

πŸ“Ί Large screen

Supported Platforms

Platform Support
Android βœ…
Android TV βœ…
iOS βœ… (Sideloading required)
Windows βœ…
macOS βœ…
Linux βœ…

✨ Features

πŸ’‘ SkyStream is designed as a scalable, plugin-driven, cross-platform streaming platformβ€”delivering flexibility, performance, and a seamless viewing experience across all devices.

πŸ”Ž Powerful Search & Discovery

  • πŸ” Plugin-wise Search – Search within specific providers for more accurate results
  • πŸ’‘ Smart Search Suggestions – Get real-time suggestions while typing
  • 🌐 Advanced Discovery (TMDB Integration) – Explore trending, popular, and filtered content
  • 🎯 Custom Home Experience – Set Explore as your default landing screen
  • 🌍 Multi-language Filtering – Discover content across 40+ languages

🎬 Advanced Streaming Experience

  • πŸ“Ί Live Streaming Support – Watch live content with improved reliability
  • ▢️ Resume Playback – Continue watching from where you left off
  • ⏩ Playback Speed Control – Adjust speed to your preference
  • 🎚️ Default Quality Selection – Set preferred streaming quality
  • πŸ“‘ Episode Overlay – Browse and switch episodes inside the player
  • πŸ” Detailed Loading Insights – View source details while content loads

🌐 Multi-Provider & Plugin System

  • πŸ”Œ Plugin-Based Architecture – Extend functionality with custom plugins
  • πŸ” Multi-Provider Support – Access multiple content sources within a single plugin
  • 🌍 Domain Switching – Switch domains seamlessly for better availability
  • πŸͺ΅ In-App Logs (Developer Tools) – Debug plugins directly inside the app

πŸ’¬ Subtitles & Content Flexibility

  • 🌍 External Subtitles Support – Integrated with:
    • OpenSubtitles
    • SubDL
    • Subsource
  • πŸ“ Subtitle Styling – Customizable font size and colors

πŸ“₯ Offline & External Playback

  • ⬇️ Download Content – Watch offline anytime
  • πŸŽ₯ External Player Support – Play content in your preferred media player

πŸ“Ί Cross-Platform Support

  • πŸ“± Android & iOS
  • πŸ’» macOS, Windows & Linux
  • πŸ“Ί Android TV + tvOS (Apple TV) support

⚑ Performance & Reliability

  • πŸš€ Optimized Performance – Faster load times and smoother UI
  • 🧠 New JavaScript Engine (quick_js_ng) – Better execution and compatibility
  • 🌐 DNS over HTTPS – Bypass ISP restrictions for improved access
  • πŸ“‰ Reduced App Size – Lightweight and efficient
  • πŸ”§ Stability Improvements – Enhanced reliability across all platforms

🎨 Modern UI/UX

  • 🎨 Clean & Modern Interface – Redesigned Home and Details screens
  • 🧭 Improved Navigation – Explore-based content discovery
  • πŸŒ— Theme Improvements – Better light mode and UI consistency
  • πŸ–₯️ Enhanced Desktop Experience – Improved windowed mode support

🌍 Global Accessibility

  • 🌐 40+ Language Support – Fully localized experience
  • 🎯 Region-aware Discovery – Content tailored to global audiences

πŸ“₯ Installation

Download the latest version from the Releases Page.

πŸ€– Android / Android TV

  1. Download the skystream-android-arm64-v8a-v2.2.7.apk (recommended for most modern phones) or skystream-android-armeabi-v7a-v2.2.7.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:

Guide

Steps:

  1. Download skystream-ios-unsigned-v2.2.7.ipa from the Releases Page.
  2. Open Impactor or 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.
  9. Setup Wi-Fi sync to automatically refresh your apps in background

πŸ’» Windows / macOS / Linux

  1. Download the appropriate file for your OS (skystream-windows.exe, skystream-macos.dmg, skystream-linux.deb, etc.).
  2. Install the app.
  3. Run the application from your app launcher or terminal.
    • macOS Note: If you see an β€œUnidentified Developer” warning, go to Settings β†’ Privacy & Security and click Open Anyway to allow the app (one-time step).
    • Linux Note: You may need to install the following packages:
      sudo apt-get update
      sudo apt-get install -y clang cmake ninja-build pkg-config libgtk-3-dev liblzma-dev libmpv-dev libasound2-dev

πŸ› οΈ Build from Source

To set up the development environment, clone the repository and run the setup commands. Detailed instructions for environment configuration, platform-specific builds, and project architecture can be found in our contributor guide:

πŸ‘‰ CONTRIBUTING.md

Quick Start

git clone https://github.com/akashdh11/skystream.git
cd skystream
flutter pub get
flutter gen-l10n
dart run build_runner build --delete-conflicting-outputs
flutter run

🀝 Contributing

We welcome contributions of all kinds! Whether you are fixing a bug, adding a feature, or helping with translations, your help is appreciated.


FAQ

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

Star History

Star History

Star History Chart

Contributors

License

MIT

About

SkyStream is a modern, cross-platform media streaming client inspired by CloudStream. It utilizes a custom JavaScript runtime for extensions, allowing users to scrape and stream content from various sources on Android, iOS, Windows, macOS, and Linux from a single codebase.

Resources

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Dart 49.0%
  • C 41.1%
  • C++ 2.5%
  • Go 1.7%
  • Kotlin 1.4%
  • CMake 1.1%
  • Other 3.2%