[![Contributors][contributors-shield]][contributors-url] [![Forks][forks-shield]][forks-url] [![Stargazers][stars-shield]][stars-url] [![Issues][issues-shield]][issues-url] [![License][license-shield]][license-url]
Nuvio Logo

🎬 Nuvio Media Hub

A modern media hub built with React Native and Expo
Addon ecosystem • Cross‑platform • Offline metadata & sync

Get Started Âť

View Screenshots ¡ Report Bug ¡ Request Feature

Table of Contents
  1. About The Project
  2. Screenshots
  3. Getting Started
  4. Usage Notes
  5. Contributing
  6. Support
  7. License
  8. Contact
  9. Acknowledgments
## About The Project Nuvio Media Hub is a cross‑platform app for managing, discovering, and streaming your media via a flexible addon ecosystem. Built with React Native + Expo, it integrates providers and sync services while keeping a simple, fast UI. ### Key Features * **🌐 Addon Ecosystem** – Integrate multiple providers and services * **⚡ Fast & Modern UI** – React Native + Expo with optimized navigation * **📱 Cross‑Platform** – iOS, Android, and Web (Expo) support * **🔐 Privacy‑First** – No bundled content; you control sources via addons * **🗂️ Library Sync** – Keep metadata and progress in sync across devices * **🧩 Extensible** – Community addons, customizations, and theme support ### Built With


React Native • Expo • TypeScript

## Demo | Home | Details | |:----:|:-------:| | ![Home](screenshots/Simulator%20Screenshot%20-%20iPhone%2016%20Pro%20-%202025-08-27%20at%2021.08.32-portrait.png) | ![Details](screenshots/WhatsApp%20Image%202025-09-02%20at%2000.24.31-portrait.png) |

(back to top)

## Getting Started Follow the steps below to run the app locally. ### Installation ```bash git clone https://github.com/tapframe/NuvioStreaming.git cd NuvioStreaming npm install npx expo start ``` ### Build ```bash npx expo run:android # Android npx expo run:ios # iOS ```
Alternative iOS Installation ### AltStore [![Add to AltStore](https://img.shields.io/badge/Add%20to-AltStore-blue?style=for-the-badge)](https://tinyurl.com/NuvioAltstore) ### SideStore [![Add to SideStore](https://img.shields.io/badge/Add%20to-SideStore-green?style=for-the-badge)](https://tinyurl.com/NuvioSidestore) **Manual URL:** `https://raw.githubusercontent.com/tapframe/NuvioStreaming/main/nuvio-source.json`

(back to top)

## Usage Notes * Nuvio ships without built‑in content. Install addons to access sources. * Some providers may require accounts, API keys, or region access. * Performance depends on device and provider; enable caching where available.

(back to top)

## Contributing Contributions make the open‑source community amazing! Any contributions are greatly appreciated. 1. Fork the project 2. Create your feature branch (`git checkout -b feature/AmazingFeature`) 3. Commit your changes (`git commit -m 'Add some AmazingFeature'`) 4. Push to the branch (`git push origin feature/AmazingFeature`) 5. Open a Pull Request

(back to top)

## Support If you find Nuvio helpful, consider supporting development: * **Ko‑Fi** – `https://ko-fi.com/tapframe` * **GitHub Star** – Star the repo to show support * **Share** – Tell others about the project

(back to top)

## License Distributed under the GNU GPLv3 License. See `LICENSE` for more information.

(back to top)

## Contact **Project Links:** * GitHub: `https://github.com/tapframe` * Issues: `https://github.com/tapframe/NuvioStreaming/issues`

(back to top)

## Acknowledgments * [React Native](https://reactnative.dev/) * [Expo](https://expo.dev/) * [TypeScript](https://www.typescriptlang.org/) * Community contributors and testers **Disclaimer:** This application functions as a media hub with addon/plugin support. It does not contain any built‑in content or host media content. Content access is only available through user‑installed plugins and addons. Any legal concerns should be directed to the specific websites providing the content.

(back to top)

[contributors-shield]: https://img.shields.io/github/contributors/tapframe/NuvioStreaming.svg?style=for-the-badge [contributors-url]: https://github.com/tapframe/NuvioStreaming/graphs/contributors [forks-shield]: https://img.shields.io/github/forks/tapframe/NuvioStreaming.svg?style=for-the-badge [forks-url]: https://github.com/tapframe/NuvioStreaming/network/members [stars-shield]: https://img.shields.io/github/stars/tapframe/NuvioStreaming.svg?style=for-the-badge [stars-url]: https://github.com/tapframe/NuvioStreaming/stargazers [issues-shield]: https://img.shields.io/github/issues/tapframe/NuvioStreaming.svg?style=for-the-badge [issues-url]: https://github.com/tapframe/NuvioStreaming/issues [license-shield]: https://img.shields.io/github/license/tapframe/NuvioStreaming.svg?style=for-the-badge [license-url]: http://www.gnu.org/licenses/gpl-3.0.en.html