Nuvio - Streaming App

Nuvio is an Open-Source cross-platform streaming application built with React Native and Expo, allowing users to browse, discover, and watch video content.

✨ Features

Home Screen: Customizable dashboard featuring highlighted content, continue watching section, and access to various content catalogs.
Content Discovery: Explore trending, popular, or categorized movies and TV shows.
Detailed Metadata: Access comprehensive information for content, including descriptions, cast, crew, and ratings.
Catalog Browsing: Navigate through specific genres, curated lists, or addon-provided catalogs.
Video Playback: Integrated video player for watching content.
Stream Selection: Choose from available video streams provided by configured sources/addons.
Search Functionality: Search for specific movies, TV shows, or other content.
Personal Library: Manage a collection of favorite movies and shows.
Trakt.tv Integration: Sync watch history, collection, and watch progress with your Trakt account.
Addon Management: Configure and manage Stremio-like addons to source content streams and catalogs.
Release Calendar: View upcoming movie releases or TV show episode air dates.
Extensive Settings:
- Player customization (e.g., subtitle preferences).
- Content source configuration (TMDB API keys, MDBList URLs).
- Catalog management and visibility.
- Trakt account connection.
- Notification preferences.
- Home screen layout adjustments.
Optimized & Interactive UI: Smooth browsing with skeleton loaders, pull-to-refresh, performant lists, haptic feedback, and action menus.
Cross-Platform: Runs on iOS and Android (highly optimized for iOS; Android performance is generally good).

🚀 Tech Stack

Framework: React Native (v0.76.9) with Expo (SDK 52)
Language: TypeScript
Navigation: React Navigation (v7)
Video Playback: react-native-video
UI Components: react-native-paper, @gorhom/bottom-sheet, @shopify/flash-list
State Management/Async: Context API, axios
Animations & Gestures: react-native-reanimated, react-native-gesture-handler
Data Sources (Inferred): TMDB (The Movie Database), potentially Stremio-related services

🛠️ Setup & Running

Prerequisites:
- Node.js (LTS recommended)
- npm or yarn
- Expo Go app on your device/simulator (for development) or setup for native builds (Android Studio/Xcode).

Clone the repository:

git clone https://github.com/nayifleo1/NuvioExpo.git
cd nuvio

Install dependencies:
```
npm install
# or
yarn install
```
Run the application:
- For Expo Go (Development):
```
npm start 
# or
yarn start
```
  Scan the QR code with the Expo Go app on your iOS or Android device.
- For Native Android Build/Emulator:
```
npm run android
# or
yarn android
```
- For Native iOS Build/Simulator:
```
npm run ios
# or
yarn ios
```

🤝 Contributing

Contributions are welcome! If you'd like to contribute, please follow these general steps:

Fork the repository.
Create a new branch for your feature or bug fix (git checkout -b feature/your-feature-name or bugfix/issue-number).
Make your changes and commit them with descriptive messages.
Push your branch to your fork (git push origin feature/your-feature-name).
Open a Pull Request to the main repository's main or develop branch (please check which branch is used for development).

Please ensure your code follows the project's coding style and includes tests where applicable.

🐛 Reporting Issues

If you encounter any bugs or have suggestions, please open an issue on the GitHub repository. Provide as much detail as possible, including:

Steps to reproduce the issue.
Expected behavior.
Actual behavior.
Screenshots or logs, if helpful.
Your environment (OS, device, app version).

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

4.3 KiB Raw Blame History