# 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>

---

## Beta Release
This application is currently in beta. Please report any issues you encounter.

[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