# Nuvio Media Player

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

<p align="center">
  A modern media player built with React Native and Expo, featuring comprehensive addon integration and content synchronization.
</p>

---

## Installation

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

---

## Features

- **Content Discovery:** Personalized recommendations, advanced search, rich metadata
- **Media Playback:** Dual player support, quality selection, subtitle integration
- **Platform Sync:** Trakt.tv synchronization, Stremio addon compatibility
- **Modern UI:** Material Design, dynamic theming, cross-platform native experience

---

## Screenshots

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

---

## Tech Stack

<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

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

---

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

---

## Disclaimer

This application functions as a media player with addon/plugin support. It does not contain any built-in content sources 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.