FilmPlus Nuvio Provider

A collection of streaming providers for the Nuvio app based on sources found in the FilmPlus Android application.

📺 Supported Sources

This provider includes adapters for multiple streaming platforms:

• Repelis (repelis.red) - Spanish streaming platform
• Pelisplay (pelisplay.co) - Movies and TV shows
• PelisXD (pelisxd.com) - Content streaming
• RexPelis (rexpelis.com) - Movies and series
• WAAW.TV (waaw.tv) - Video streaming
• AllPeliculas (allpeliculas.mx) - Latin American content
• PelisHouse (pelishouse.com) - Entertainment hub
• Dooood (dooood.com) - Video hosting

🚀 Quick Start

Adding to Nuvio

1. Open Nuvio app
2. Go to Settings → Plugins/Providers
3. Add provider URL:

   https://raw.githubusercontent.com/YOUR_USERNAME/filmplus-nuvio-provider/main
   

4. Refresh and enable the providers

Manual Installation

1. Clone this repository:

   git clone https://github.com/YOUR_USERNAME/filmplus-nuvio-provider.git
   cd filmplus-nuvio-provider

2. Install dependencies:

   npm install

3. Build providers:

   npm run build

4. The compiled providers will be in the providers/ directory

📁 Project Structure

filmplus-nuvio-provider/
├── src/
│   └── filmplus/
│       ├── index.js          # Main provider logic
│       ├── http.js           # HTTP utilities
│       └── extractor.js      # Stream extraction
├── providers/                # Compiled providers (auto-generated)
│   ├── filmplus.js
│   ├── repelis.js
│   ├── pelisplay.js
│   └── ...
├── manifest.json             # Provider registry
├── package.json
├── build.js                  # Build script
└── README.md

🔧 Development

Building

Build all providers:

npm run build

Build specific provider:

node build.js filmplus

Watch Mode

Automatically rebuild on file changes:

npm run build:watch

Testing

Create a test file:

// test.js
const { getStreams } = require('./providers/filmplus.js');

async function test() {
  const streams = await getStreams('872585', 'movie'); // Oppenheimer
  console.log('Found streams:', streams.length);
  streams.forEach(s => console.log(s.title));
}

test();

Run test:

node test.js

📋 Provider Features

Each provider supports:

• Movies - Full-length films
• TV Shows - Series with season/episode support
• Multiple Formats - M3U8, MP4, MKV streams
• Quality Selection - Various resolution options
• Stream Metadata - Title, quality, headers for playback

⚠️ Important Notes

• Legal Disclaimer: This provider aggregates publicly available streaming links. Users are responsible for ensuring their use complies with local laws.
• Rate Limiting: Providers include retry logic to handle temporary server issues
• User-Agent: Requests include proper headers to minimize blocking
• Error Handling: Graceful fallback when sources are unavailable

🛠️ Stream Object Format

Providers return streams in this format:

{
  name: "FilmPlus",                    // Provider name
  title: "1080p Stream",               // Description
  url: "https://streaming-url/video.m3u8",  // Stream URL
  quality: "1080p",                    // Quality label
  size: "2.5 GB",                      // Optional file size
  headers: {                           // Optional playback headers
    "Referer": "https://source.com",
    "User-Agent": "Mozilla/5.0..."
  }
}

🤝 Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b add-provider
3. Add your provider code
4. Test thoroughly: node test.js
5. Build: npm run build
6. Create a pull request

📚 API Reference

getStreams(tmdbId, mediaType, season, episode)

Fetches available streams for a media item.

Parameters:

• tmdbId (string): TMDB database ID
• mediaType (string): 'movie' or 'tv'
• season (number): Season number (TV only)
• episode (number): Episode number (TV only)

Returns: Promise - Array of stream objects

🔐 Privacy & Security

• No personal data is stored or transmitted
• All requests use standard HTTP headers
• HTTPS is used for API communications
• Providers run locally in the Nuvio app

📄 License

Licensed under GNU General Public License v3.0. See LICENSE file.

🙋 Support

For issues, questions, or suggestions:

1. Check existing issues on GitHub
2. Open a new issue with details
3. Include error logs and screenshots if applicable

📝 Changelog

v1.0.0 (2024)

• Initial release
• Support for 8+ streaming sources
• Multi-file provider structure
• TMDB integration for metadata
• Retry logic for reliability

---

Disclaimer: This project is not affiliated with FilmPlus, Nuvio, TMDB, or any streaming platforms. It is provided for educational purposes only. Users are responsible for their use of the software in compliance with applicable laws.