mirror of
https://github.com/tapframe/NuvioStreaming.git
synced 2026-01-11 20:10:25 +00:00
202 lines
No EOL
7.6 KiB
Markdown
202 lines
No EOL
7.6 KiB
Markdown
<!-- PROJECT LOGO -->
|
||
<div align="center">
|
||
<a id="readme-top"></a>
|
||
|
||
[![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]
|
||
|
||
<br />
|
||
<br />
|
||
<img src="assets/titlelogo.png" alt="Nuvio Logo" width="120" />
|
||
<h1 align="center">🎬 Nuvio Media Hub</h1>
|
||
<p align="center">
|
||
A modern media hub built with React Native and Expo
|
||
<br />
|
||
Stremio Addon ecosystem • Cross‑platform • Offline metadata & sync
|
||
<br />
|
||
<br />
|
||
<a href="#getting-started"><strong>Get Started »</strong></a>
|
||
<br />
|
||
<br />
|
||
|
||
<a href="https://github.com/tapframe/NuvioStreaming/issues/new?labels=bug&template=bug_report.md">Report Bug</a>
|
||
·
|
||
<a href="https://github.com/tapframe/NuvioStreaming/issues/new?labels=enhancement&template=feature_request.md">Request Feature</a>
|
||
</p>
|
||
</div>
|
||
|
||
<!-- TABLE OF CONTENTS -->
|
||
<details>
|
||
<summary>Table of Contents</summary>
|
||
<ol>
|
||
<li>
|
||
<a href="#about-the-project">About The Project</a>
|
||
</li>
|
||
<li><a href="#installation">Installation</a></li>
|
||
|
||
<li><a href="#getting-started">Getting Started</a></li>
|
||
<li><a href="#contributing">Contributing</a></li>
|
||
<li><a href="#support">Support</a></li>
|
||
<li><a href="#support">Support</a></li>
|
||
<li><a href="#license">License</a></li>
|
||
<li><a href="#legal">Legal</a></li>
|
||
<li><a href="#contact">Contact</a></li>
|
||
<li><a href="#acknowledgments">Acknowledgments</a></li>
|
||
<li><a href="#built-with">Built With</a></li>
|
||
</ol>
|
||
</details>
|
||
|
||
<!-- ABOUT THE PROJECT -->
|
||
## 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.
|
||
|
||
|
||
|
||
<!-- INSTALLATION -->
|
||
## Installation
|
||
|
||
### Android
|
||
[](https://github.com/tapframe/NuvioStreaming/releases/latest)
|
||
|
||
Download the latest APK from [GitHub Releases](https://github.com/tapframe/NuvioStreaming/releases/latest)
|
||
|
||
### iOS
|
||
|
||
#### TestFlight (Recommended)
|
||
<img src="https://upload.wikimedia.org/wikipedia/fr/b/bc/TestFlight-icon.png" width="24" height="24" align="left"> [](https://testflight.apple.com/join/QkKMGRqp)
|
||
|
||
#### AltStore
|
||
<img src="https://upload.wikimedia.org/wikipedia/commons/2/20/AltStore_logo.png" width="24" height="24" align="left"> [](https://tinyurl.com/NuvioAltstore)
|
||
|
||
#### SideStore
|
||
<img src="https://github.com/SideStore/assets/blob/main/icon.png?raw=true" width="24" height="24" align="left"> [](https://tinyurl.com/NuvioSidestore)
|
||
|
||
**Manual URL:** `https://raw.githubusercontent.com/tapframe/NuvioStreaming/main/nuvio-source.json`
|
||
|
||
<p align="right">(<a href="#readme-top">back to top</a>)</p>
|
||
|
||
|
||
|
||
<!-- GETTING STARTED -->
|
||
## Getting Started
|
||
|
||
Follow the steps below to run the app locally for development. For detailed setup and troubleshooting, see [Project Documentation](docs/DOCUMENTATION.md).
|
||
|
||
### Development Build
|
||
|
||
<details>
|
||
<summary>Build from Source</summary>
|
||
|
||
```bash
|
||
git clone https://github.com/tapframe/NuvioStreaming.git
|
||
cd NuvioStreaming
|
||
npm install
|
||
# If you hit peer dependency conflicts:
|
||
# npm install --legacy-peer-deps
|
||
npx expo start
|
||
```
|
||
|
||
```bash
|
||
npx expo prebuild
|
||
npx expo run:android # Android
|
||
npx expo run:ios # iOS
|
||
```
|
||
|
||
</details>
|
||
|
||
<p align="right">(<a href="#readme-top">back to top</a>)</p>
|
||
|
||
|
||
|
||
## 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
|
||
|
||
<p align="right">(<a href="#readme-top">back to top</a>)</p>
|
||
|
||
## 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
|
||
|
||
<p align="right">(<a href="#readme-top">back to top</a>)</p>
|
||
|
||
## License
|
||
|
||
Distributed under the GNU GPLv3 License. See `LICENSE` for more information.
|
||
|
||
<p align="right">(<a href="#readme-top">back to top</a>)</p>
|
||
|
||
## Legal
|
||
|
||
For comprehensive legal information, including our full disclaimer, third-party extension policy, and DMCA/Copyright information, please visit our **[Legal & Disclaimer Page](https://tapframe.github.io/NuvioStreaming/#legal)**.
|
||
|
||
**Disclaimer:** Nuvio functions solely as a client-side interface for browsing metadata and playing media files provided by user-installed extensions. It does not host, store, or distribute any media content.
|
||
|
||
<p align="right">(<a href="#readme-top">back to top</a>)</p>
|
||
|
||
## Contact
|
||
|
||
**Project Links:**
|
||
* GitHub: `https://github.com/tapframe`
|
||
* Issues: `https://github.com/tapframe/NuvioStreaming/issues`
|
||
|
||
<p align="right">(<a href="#readme-top">back to top</a>)</p>
|
||
|
||
## 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.
|
||
|
||
<p align="right">(<a href="#readme-top">back to top</a>)</p>
|
||
|
||
## Built With
|
||
|
||
<p align="left">
|
||
<a href="https://skillicons.dev">
|
||
<img src="https://skillicons.dev/icons?i=react,typescript,nodejs,expo,github,githubactions&theme=light&perline=6" />
|
||
</a>
|
||
<br/>
|
||
React Native • Expo • TypeScript
|
||
</p>
|
||
|
||
## Star History
|
||
|
||
<a href="https://www.star-history.com/#tapframe/NuvioStreaming&type=date&legend=top-left">
|
||
<picture>
|
||
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=tapframe/NuvioStreaming&type=date&theme=dark&legend=top-left" />
|
||
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=tapframe/NuvioStreaming&type=date&legend=top-left" />
|
||
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=tapframe/NuvioStreaming&type=date&legend=top-left" />
|
||
</picture>
|
||
</a>
|
||
|
||
<p align="right">(<a href="#readme-top">back to top</a>)</p>
|
||
|
||
<!-- MARKDOWN LINKS & IMAGES -->
|
||
[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 |