pstreams-providers/README.md

59 lines
2.9 KiB
Markdown

# @p-stream/providers
READ: Most sources marked with 🔥 or 🤝 are only avaliable on https://pstream.mov
Because these scrapers are getting harder and harder to maintain, as they get patched. We need to close-source them. This is unfortunate, but it's the reality of the pirating scene. Sites that we scrape are blocking us, and we keep losing them. Fortunately, P-Stream has partnered with many people who offered their services on the site.
You are still free to self-host; several sources are still usable, with more open-source ones coming soon. If you have experience coding, this is a great oppurtunity to develop your own scrapers.
package that holds all providers of P-Stream.
Feel free to use for your own projects.
features:
- scrape popular streaming websites
- works in both browser and server-side
Visit documentation here: https://providers.pstream.mov/
## Provider Status (Updated September 2, 2025)
Based on comprehensive testing with Fight Club (TMDB ID: 550), here's the current status of providers:
### ✅ Working Providers (5/11 tested - 45% success rate)
| Provider | Type | Quality | Notes |
|----------|------|---------|-------|
| **cloudnestra** | HLS | Multiple | Proxy depth 2, reliable streaming |
| **rgshows** | HLS | Multiple | Custom headers, stable performance |
| **lookmovie** | HLS | Multiple | 44 subtitle languages, IP-locked |
| **vidnest** | Embeds | Variable | Returns 2 embed URLs (hollymoviehd, allmovies) |
| **hdrezka** | MP4 | 4 levels | Direct file streams, 3 subtitle languages |
### ❌ Disabled Providers (6/11 tested)
| Provider | Issue | Details |
|----------|--------|---------|
| **ridomovies** | Broken embeds | Closeload embed scraper has corrupted decoding |
| **tugaflix** | Geo-blocking | Streamtape embeds blocked in India |
| **fsharetv** | Geo-blocking | Works only with VPN, provides excellent MP4 streams |
| **animetsu** | Broken logic | Returns embed URLs but no actual streams |
| **wecima** | Complex structure | Arabic site with obfuscated JavaScript player |
| **zunime** | API issues | Authentication problems with backend services |
### 🌍 Common Issues
1. **Geo-blocking**: Major issue affecting multiple providers (ridomovies, tugaflix, fsharetv)
2. **Embed Dependencies**: Many providers rely on third-party embeds that get broken/blocked
3. **Anti-Bot Protection**: Sites frequently update obfuscation methods
4. **Domain Changes**: Streaming sites change domains to avoid blocking
### 🔧 Technical Infrastructure
- **Proxy System**: Multi-level proxy support with depth configuration (0, 1, 2)
- **Fetcher Types**: Native, Browser, Browser Extension support
- **Stream Types**: HLS, MP4, File-based with quality selection
- **Subtitle Support**: Multiple languages with VTT format
- **Headers/CORS**: Automatic handling of referer, origin, and CORS restrictions
## How to run locally or test my changes
These topics are also covered in the documentation