NuvioStreaming/README.md
2025-06-20 19:31:30 +05:30

134 lines
No EOL
3.6 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 app built with React Native and Expo, featuring Stremio addon integration, Trakt synchronization, and a beautiful user interface.
</p>
## ⚠️ Alpha Testing
This app is currently in alpha testing. Please report any bugs or issues you encounter.
[Download Latest Release](https://github.com/tapframe/NuvioStreaming/releases/latest)
## ✨ 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) |
## 🚀 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
## 📝 Changelog
See [CHANGELOG.md](CHANGELOG.md) for release history and changes.
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🙏 Acknowledgments
Built with help from the amazing communities behind:
- React Native & Expo
- TMDB API
- Trakt.tv
- Stremio
---
<p align="center">
<em>Happy Streaming! 🎬</em>
</p>