mirror of
https://github.com/tapframe/NuvioStreaming.git
synced 2026-01-11 20:10:25 +00:00
202 lines
No EOL
7.2 KiB
Markdown
202 lines
No EOL
7.2 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>
|
|
|
|
---
|
|
|
|
## ⚠️ 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)
|
|
|
|
---
|
|
|
|
## 📱 Installation
|
|
|
|
### AltStore Installation
|
|
<img src="https://upload.wikimedia.org/wikipedia/commons/2/20/AltStore_logo.png" width="32" height="32" align="left"> [](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"> [](https://tinyurl.com/NuvioSidestore)
|
|
|
|
**Manual URL:** `https://raw.githubusercontent.com/tapframe/NuvioStreaming/main/nuvio-source.json`
|
|
|
|
---
|
|
|
|
## ✨ Key Features
|
|
|
|
### 🎬 Content Discovery & Management
|
|
- **Smart Home Screen:** Personalized content recommendations and continue watching functionality
|
|
- **Advanced Search:** Instant results with comprehensive filtering capabilities
|
|
- **Rich Metadata Display:** Detailed information, cast, crew, ratings, and similar content
|
|
- **Calendar Integration:** Track upcoming episodes and releases with notification support
|
|
- **Library Management:** Personal collections with watch history and progress tracking
|
|
- **Cast & Crew Exploration:** Dedicated actor/director filmographies and detailed profiles
|
|
|
|
### 🎥 Streaming & Playbook
|
|
- **Dual Video Player Support:**
|
|
- Built-in React Native Video player with gesture controls
|
|
- External player integration for enhanced compatibility
|
|
- Auto-quality selection and subtitle customization
|
|
- **Intelligent Stream Selection:** Automatically finds the best available quality
|
|
- **Trailer Integration:** Seamless trailer playback with preloading capabilities
|
|
- **Auto-Play Functionality:** Continuous episode watching experience
|
|
- **Progress Tracking:** Resume from where you left off across devices
|
|
|
|
### 🔗 Third-Party Integrations
|
|
- **Trakt.tv Synchronization:**
|
|
- Complete watch history and rating sync
|
|
- Library management and progress tracking
|
|
- Auto-sync capabilities with background updates
|
|
- **Stremio Addon Ecosystem:**
|
|
- Full compatibility with Stremio addon system
|
|
- Easy addon management and installation
|
|
- Support for multiple content sources
|
|
- **TMDB Integration:** Comprehensive metadata and high-quality imagery
|
|
- **MDBList Support:** Additional ratings and personalized recommendations
|
|
- **Local Scraper System:** Custom content source integration
|
|
|
|
### 🎨 User Experience & Interface
|
|
- **Modern Material Design:** Clean, intuitive interface with smooth animations
|
|
- **Dynamic Theming:** Dominant color extraction for content-based UI theming
|
|
- **Theme Customization:** Multiple color schemes and display preferences
|
|
- **Optimized Performance:** Image caching and efficient list rendering
|
|
- **Cross-Platform Support:** Native experience on both iOS and Android
|
|
|
|
### 🔔 Smart Features
|
|
- **Push Notifications:** New episode alerts and personalized reminders
|
|
- **Background Sync:** Automatic data updates and content synchronization
|
|
- **Onboarding Experience:** Guided setup for new users
|
|
- **Comprehensive Settings:** Extensive customization options
|
|
- **Offline Functionality:** Robust caching system for improved performance
|
|
|
|
---
|
|
|
|
## 📸 Screenshots
|
|
|
|
| Home Screen | Details Page | Home Screen 2 |
|
|
|:-----------:|:------------:|:-------------:|
|
|
|  |  |  |
|
|
|
|
| Library | Player Loading | Video Player |
|
|
|:-------:|:--------------:|:------------:|
|
|
|  |  |  |
|
|
|
|
| Ratings | Episodes & Seasons | Search & Details |
|
|
|:-------:|:------------------:|:----------------:|
|
|
|  |  |  |
|
|
|
|
---
|
|
|
|
## 🧰 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
|
|
|
|
[](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!** |