NuvioStreaming/README.md
2025-09-15 22:51:28 +05:30

153 lines
No EOL
5.3 KiB
Markdown

# Nuvio Streaming App
<p align="center">
<img src="assets/titlelogo.png" alt="Nuvio Logo" width="300"/>
</p>
<p align="center">
A modern streaming application built with React Native and Expo, featuring comprehensive Stremio addon integration and Trakt.tv synchronization.
</p>
---
## Stable Release
Nuvio is now available as a stable release! Version 1.0.0 brings all major features from the beta phase, refined and optimized for the best user experience.
[Download Latest Release](https://github.com/tapframe/NuvioStreaming/tags)
---
## Installation
### AltStore Installation
<img src="https://upload.wikimedia.org/wikipedia/commons/2/20/AltStore_logo.png" width="32" height="32" align="left"> [![Add to AltStore](https://img.shields.io/badge/Add%20to-AltStore-blue?style=for-the-badge)](https://tinyurl.com/NuvioAltstore)
### SideStore Installation
<img src="https://github.com/SideStore/assets/blob/main/icon.png?raw=true" width="32" height="32" align="left"> [![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`
---
## Core Features
### Content Discovery
- **Personalized Recommendations:** Smart home screen with continue watching functionality
- **Advanced Search:** Comprehensive filtering and instant search results
- **Rich Metadata:** Detailed content information, cast, crew, and ratings
- **Calendar Integration:** Track upcoming episodes and releases
- **Library Management:** Personal collections with watch history tracking
### Streaming Experience
- **Dual Player Support:** Built-in video player with gesture controls and external player integration
- **Intelligent Quality Selection:** Automatic stream optimization and subtitle support
- **Trailer Playback:** Seamless trailer integration with preloading
- **Continuous Playback:** Auto-play functionality for uninterrupted viewing
- **Progress Synchronization:** Resume playback across devices
### Platform Integrations
- **Trakt.tv Sync:** Complete watch history, ratings, and library synchronization
- **Stremio Ecosystem:** Full addon compatibility with easy management
- **TMDB Integration:** Comprehensive metadata and high-quality imagery
- **MDBList Support:** Enhanced ratings and recommendations
- **Custom Scrapers:** Local content source integration
### User Interface
- **Material Design:** Clean, modern interface with smooth animations
- **Dynamic Theming:** Content-based color extraction and customization
- **Cross-Platform:** Native experience on iOS and Android
- **Performance Optimized:** Efficient rendering and image caching
### Advanced Features
- **Push Notifications:** New episode alerts and content reminders
- **Background Synchronization:** Automatic data updates and content sync
---
## Screenshots
| Home Screen | Details Page | Home Screen 2 |
|:-----------:|:------------:|:-------------:|
| ![Home Screen](screesnhots/Simulator%20Screenshot%20-%20iPhone%2016%20Pro%20-%202025-08-27%20at%2021.08.32-portrait.png) | ![Details Page](screesnhots/WhatsApp%20Image%202025-09-02%20at%2000.24.31-portrait.png) | ![Home Screen 2](screesnhots/Simulator%20Screenshot%20-%20iPhone%2016%20Pro%20-%202025-08-27%20at%2021.09.43-portrait.png) |
| Library | Player Loading | Video Player |
|:-------:|:--------------:|:------------:|
| ![Library](screesnhots/Simulator%20Screenshot%20-%20iPhone%2016%20Pro%20-%202025-08-27%20at%2021.10.14-portrait.png) | ![Player Loading](screesnhots/Simulator%20Screenshot%20-%20iPhone%2016%20Pro%20-%202025-08-27%20at%2021.12.41-landscape.png) | ![Video Player](screesnhots/Simulator%20Screenshot%20-%20iPhone%2016%20Pro%20-%202025-08-27%20at%2021.13.36-landscape.png) |
| Ratings | Episodes & Seasons | Search & Details |
|:-------:|:------------------:|:----------------:|
| ![Ratings](screesnhots/ratingscreen-portrait.png) | ![Episodes & Seasons](screesnhots/seasonandepisode-portrait.png) | ![Search & Details](screesnhots/search-portrait.png) |
---
## Tools & Technologies
<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>
</p>
---
## Development
### Prerequisites
- Node.js 18+
- npm or yarn
- Expo CLI
### Setup
```bash
git clone https://github.com/tapframe/NuvioStreaming.git
cd NuvioStreaming
npm install
npx expo start
```
### Build Commands
```bash
npx expo run:android # Android build
npx expo run:ios # iOS build
```
---
## Contributing
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request
---
## Issues
Report bugs and request features via [GitHub Issues](https://github.com/tapframe/NuvioStreaming/issues)
---
## License
[![GNU GPLv3](https://www.gnu.org/graphics/gplv3-127x51.png)](http://www.gnu.org/licenses/gpl-3.0.en.html)
This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.
---
## Disclaimer
This application functions as a content aggregator, accessing publicly available streams from third-party sources. No media content is hosted by this application. Users are responsible for compliance with applicable laws and regulations.
---
## Acknowledgments
Built with support from:
- React Native & Expo
- TMDB API
- Trakt.tv
- Stremio