v1.0.2 CinePro Release!🥳

CinePro Backend - Release v1.0.2

🎬 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

⚠️ Limited Maintenance Mode

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:

1. Bug Reports: Use our issue templates
2. Security Issues: Report privately to maintainers
3. Pull Requests: Follow existing code style
4. 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

v1.0.0 CinePro Release!🥳

CinePro Backend - Release v1.0.0

🎬 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

🛠️ Installation & Setup

Prerequisites

• Node.js 18+
• npm or yarn
• TMDB API Key (free from themoviedb.org)

Quick Start

1. Clone the repository

   git clone https://github.com/cinepro-org/backend.git
   cd backend

2. Install dependencies

   npm install

3. Environment Setup

   cp .env.example .env
   # Edit .env file and add your TMDB_API_KEY

4. Start the server

   npm start

5. Access the API

   http://localhost:3000
   

Docker Deployment

# Build the image
docker build -t cinepro-backend .

# Run the container
docker run -p 3000:3000 -e TMDB_API_KEY=your_api_key_here cinepro-backend

📡 API Usage

Get Movie Sources

GET /movie/{tmdbId}

Example:

curl http://localhost:3000/movie/155

Get TV Show Episode Sources

GET /tv/{tmdbId}?s={season}&e={episode}

Example:

curl "http://localhost:3000/tv/1399?s=1&e=1"

Cache Statistics

GET /cache-stats

Response Format

{
  "files": [
    {
      "file": "https://example.com/stream.m3u8",
      "type": "hls",
      "lang": "en"
    }
  ],
  "subtitles": [
    {
      "url": "https://example.com/subtitles.vtt",
      "lang": "en",
      "type": "vtt"
    }
  ]
}

📚 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

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

⚠️ Limited Maintenance Mode

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:

1. Bug Reports: Use our issue templates
2. Security Issues: Report privately to maintainers
3. Pull Requests: Follow existing code style
4. 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.

---

⭐ If this project helped you, please consider starring the repository!

Made with ❤️ by the CinePro Team