π¬ About CinePro Backend
CinePro Backend is an open-source movie and TV show scraper API that aggregates streaming sources from various providers. This project provides a RESTful API to retrieve streaming links and subtitles for movies and TV shows using TMDB IDs.
β οΈ Important Notice
This project is for educational purposes only. We do not host any content - we only provide links to existing content on the internet. This is not meant for public hosting and should be used for personal use only.
π Features
- β No Ads, No Tracking - Clean, privacy-focused API
- π₯ Movie Support - Full movie streaming source aggregation
- πΊ TV Show Support - Episode-based streaming (limited support)
- π Caching System - Built-in node-cache for performance optimization
- π Multiple Providers - Scrapes from various streaming sources
- π Subtitle Support - Multi-language subtitle retrieval
- π OpenAPI Documentation - Complete API specification included
- π³ Docker Support - Ready-to-deploy containerization
π Documentation
- OpenAPI Specification:
openapi.yaml - View Documentation: Use Swagger Editor or Stoplight Studio
- API Reference: Complete endpoint documentation with examples
π§© Supported Providers
The API aggregates sources from multiple streaming providers:
- VidSrc - Primary movie/TV sources
- VidSrcCC - Alternative streaming links
- MultiEmbed - Multiple embed sources
- AutoEmbed - Automated embedding
- Xprime - Premium source aggregation
- PrimeWire - Legacy provider support
- And many more...
π§ Configuration
Environment Variables
PORT=3000 # Server port (default: 3000)
TMDB_API_KEY=your_api_key # Required: TMDB API key
NODE_ENV=production # Environment mode
ALLOWED_ORIGINS=[] # Add allowed origins here. Example ["http://localhost:3001", "https://cinepro.mintlify.app"]Cache Configuration
The built-in caching system stores scraped data for 3 hours by default to improve performance and reduce redundant scraping.
π‘οΈ Maintenance Status
Note
This project is currently in limited maintenance mode. While the current release is stable and functional, active development has been reduced due to time constraints.
- β Bug fixes for critical issues will be addressed
- β Security updates will be maintained
- β New features are unlikely to be added
- β Provider updates may be delayed
What This Means:
- The current version works as intended
- Community contributions are welcome
- Fork the project for custom modifications
- Consider this a "stable archive" release
π€ Contributing
We welcome community contributions! Even though active development is limited:
- Bug Reports: Use our issue templates
- Security Issues: Report privately to maintainers
- Pull Requests: Follow existing code style
- Provider Updates: Community PRs for new providers are appreciated
Development Setup
npm run dev # Development with hot reload
npm run main # Standard development modeπ License & Legal
License
Personal and Non-Commercial Use Only
- β Personal use allowed
- β Educational purposes
- β Commercial use prohibited
- β Redistribution for profit prohibited
- β Adding ads/tracking prohibited
Legal Disclaimer
This project is for educational purposes only. We:
- Do not host any content
- Provide links to existing internet content
- Are not responsible for content accuracy or legality
- Do not upload or store media files
If you have legal concerns, contact the appropriate content owners or hosting sites.
π Support & Community
- Issues: GitHub Issues
- Documentation: CinePro Docs
- Repository: GitHub Repository
π Acknowledgments
- Thanks to all contributors who helped build this project. In words @nischaldoescode , @Inside4ndroid and @LorisRue and others!
π¦ Release Information
Version: v1.0.0
Release Date: September 2025
Node.js Compatibility: 18+
Status: Stable - Limited Maintenance
What's Included:
- β Complete working API
- β Docker configuration
- β OpenAPI documentation
- β Multiple provider support
- β Caching system
- β Error handling
Migration Notes:
This is the first stable release. Future updates will maintain backward compatibility where possible.
π¦ Release Information
Version: v1.0.2
Release Date: October 2025
Node.js Compatibility: 18+
Status: Stable - Limited Maintenance
What's Included:
- β Reworked Proxy for better media streaming
- β GitHub Actions for automatic dependency improvements
Migration Notes:
A fetch should do it. Expected downtime should be less then 5 minutes
What's Changed
- Correct PR for bobokaha:main for Proxy and Security Enhancements by @An0n-00 in #59
- chore: format files with prettier by @github-actions[bot] in #60
- chore: format files with prettier by @github-actions[bot] in #61
- chore: update dependencies by @github-actions[bot] in #62
- chore: format files with prettier by @github-actions[bot] in #64
- Update README.md to include a message for adding bugs by @nischaldoescode in #63
- chore: update dependencies by @github-actions[bot] in #68
- chore: update dependencies by @github-actions[bot] in #69
- Fixed vidsrcCC, CinemaOS, Vidrock :) by @Inside4ndroid in #70
- chore: format files with prettier by @github-actions[bot] in #71
- chore: update dependencies by @github-actions[bot] in #72
- First November Update by @An0n-00 in #73
- refactor: improve allowed origins parsing logic for better clarity and handling by @bobokaha in #74
- chore: update dependencies by @github-actions[bot] in #75
- chore: update dependencies by @github-actions[bot] in #76
- chore: update dependencies by @github-actions[bot] in #77
- refactor: improve allowed origins parsing logic for better clarity by @An0n-00 in #78
New Contributors
- @github-actions[bot] made their first contribution in #60
- @nischaldoescode made their first contribution in #63
Full Changelog: v1.0.0...v1.0.2
β If this project helped you, please consider starring the repository!
Made with β€οΈ by the CinePro Team