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

3.6 KiB

Nuvio Streaming App

Nuvio Logo

A modern streaming app built with React Native and Expo, featuring Stremio addon integration, Trakt synchronization, and a beautiful user interface.

⚠️ Alpha Testing

This app is currently in alpha testing. Please report any bugs or issues you encounter.

Download Latest Release

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 Discover Search
Content Details Episodes & Seasons Ratings & Info
Metadata Seasons Rating

🚀 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:

    git clone https://github.com/tapframe/NuvioStreaming.git
    cd NuvioStreaming
    
  2. Install dependencies:

    npm install
    # or
    yarn install
    
  3. Start the development server:

    npx expo start
    
  4. Run on device/simulator:

    • Scan QR code with Expo Go app
    • Or run native builds:
      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 with:

  • Clear description of the problem/suggestion
  • Steps to reproduce (for bugs)
  • Expected behavior
  • Screenshots if applicable

📝 Changelog

See CHANGELOG.md for release history and changes.

📄 License

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

🙏 Acknowledgments

Built with help from the amazing communities behind:

  • React Native & Expo
  • TMDB API
  • Trakt.tv
  • Stremio

Happy Streaming! 🎬