#  Nuvio Streaming App

<p align="center">
  <img src="assets/titlelogo.png" alt="Nuvio Logo" width="300"/>
</p>

<p align="center">
  A modern streaming app built with React Native and Expo, featuring Stremio addon integration, Trakt synchronization, and a beautiful user interface.
</p>

---

## ⚠️ Beta Testing
This app is currently in Beta testing. Please report any bugs or issues you encounter.

[Download Latest Release](https://github.com/tapframe/NuvioStreaming/tags)

---

## ✨ Key Features 

### Content & Discovery
- **Smart Home Screen:** Personalized content recommendations and continue watching
- **Discover Section:** Browse trending and popular movies & TV shows
- **Rich Metadata:** Detailed information, cast, ratings, and similar content
- **Powerful Search:** Find content quickly with instant results

### Streaming & Playback
- **Advanced Video Player:** 
  - Built-in player with gesture controls
  - External player support
  - Auto-quality selection
  - Subtitle customization
- **Smart Stream Selection:** Automatically finds the best available streams
- **Auto-Play:** Seamless playback of next episodes
- **Continue Watching:** Resume from where you left off

### Integration & Sync
- **Trakt Integration:**
  - Account synchronization
  - Watch history tracking
  - Library management
  - Progress syncing
- **Stremio Addons:**
  - Compatible with Stremio addon system
  - Easy addon management
  - Multiple source support

### User Experience
- **Modern UI/UX:** Clean, intuitive interface with smooth animations
- **Performance:** Optimized for smooth scrolling and quick loading
- **Customization:** Theme options and display preferences
- **Cross-Platform:** Works on both iOS and Android

---

## 📸 Screenshots

| Home & Continue Watching | Discover & Browse | Search & Details |
|:-----------------------:|:-----------------:|:----------------:|
| ![Home](src/assets/home.jpg) | ![Discover](src/assets/discover.jpg) | ![Search](src/assets/search.jpg) |
| **Content Details** | **Episodes & Seasons** | **Ratings & Info** |
| ![Metadata](src/assets/metadascreen.jpg) | ![Seasons](src/assets/seasonandepisode.jpg) | ![Rating](src/assets/ratingscreen.jpg) |

---

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

---

## 🚀 Getting Started

### Prerequisites
- Node.js 18 or newer
- npm or yarn
- Expo Go app (for development)
- Android Studio (for Android builds)
- Xcode (for iOS builds)

### Development Setup
1. Clone the repository:
   ```bash
   git clone https://github.com/tapframe/NuvioStreaming.git
   cd NuvioStreaming
   ```

2. Install dependencies:
   ```bash
   npm install
   # or
   yarn install
   ```

3. Start the development server:
   ```bash
   npx expo start
   ```

4. Run on device/simulator:
   - Scan QR code with Expo Go app
   - Or run native builds:
     ```bash
     npx expo run:android
     # or
     npx expo run:ios
     ```

---

## 🤝 Contributing

We welcome contributions! Here's how you can help:

1. Fork the repository
2. Create your feature branch 
3. Commit your changes 
4. Push to the branch 
5. Open a Pull Request

---

## 🐛 Bug Reports & Feature Requests

Found a bug or have an idea? Please open an [issue](https://github.com/tapframe/NuvioStreaming/issues) with:
- Clear description of the problem/suggestion
- Steps to reproduce (for bugs)
- Expected behavior
- Screenshots if applicable

---



## 📄 License

[![GNU GPLv3 Image](https://www.gnu.org/graphics/gplv3-127x51.png)](http://www.gnu.org/licenses/gpl-3.0.en.html)

This application is **free software**: you can use, study, share, and modify it as you wish.

It is distributed under the terms of the [GNU General Public License](https://www.gnu.org/licenses/gpl.html) version 3 or later, published by the Free Software Foundation.

---

## ⚖️ DMCA Disclaimer

We hereby issue this notice to clarify that this application functions similarly to a standard web browser by fetching video files from the internet.

- **No content is hosted by this repository or the Nuvio application.**
- Any content accessed is hosted by third-party websites.
- Users are solely responsible for their usage and must comply with their local laws.

If you believe content is violating copyright laws, please contact the **actual file hosts**, **not** the developers of this repository or the Nuvio app.

---

## 🙏 Acknowledgments

Built with help from the amazing communities behind:
- React Native & Expo
- TMDB API
- Trakt.tv
- Stremio

---

**Thank You for using Nuvio!**