Introduction to CinePro Core

Learn how CinePro Core, an OMSS-compliant TypeScript streaming backend, aggregates third-party providers into a single unified API for movies and TV.

What is CinePro Core?

CinePro Core is the foundational backend service of the CinePro ecosystem, built in TypeScript on top of the Open Media Streaming Standard (OMSS) for movies and TV shows.
It acts as a unified scraping and streaming engine that aggregates multiple third‑party providers into a single, consistent API.

OMSS‑compliant backend

CinePro Core follows the OMSS specification to provide a predictable, strongly‑typed interface for discovering and streaming movies and TV shows.

Ecosystem backbone

Core powers the broader CinePro ecosystem, including an experimental frontend and CineHome, by exposing a shared HTTP API and data model.

Key features

Docker‑ready deployment

Ship CinePro Core as a container. Official multi‑architecture images are published to GitHub Container Registry (ghcr.io/cinepro-org/core); run the latest version with one command docker run -p 3000:3000 --name cinepro-core -e TMDB_API_KEY=your-tmdb-key ghcr.io/cinepro-org/core:latest!

Modular providers

CinePro maintains multiple streaming providers that fan out across different third‑party sites in parallel, decrypt and aggregate results, and return a unified list of playable sources. Providers live in the src/providers directory and can be extended without changing the core server!

Stremio addon support

CinePro can expose a Stremio addon manifest at /stremio/manifest.json. Enable it by setting STREMIO_ADDON=true in your environment.

MCP support for AI agents

CinePro Core is the first streaming backend to ever support the Model Context Protocol (MCP), letting AI agents query stream sources directly. Enable it by setting MCP_ENABLED=true in your environment. (News)

Caching & performance

Designed for production‑grade performance with support for in‑memory caching and Redis‑backed caching in containerized deployments.

CineHome integration

Integrates with the CineHome services to automate downloading and organizing media to your own storage (such as a NAS or home server). [Coming soon!]

CinePro UI (public beta)

Pair your CinePro Core instance with the CinePro UI — a browser frontend that connects to your server via its OMSS API. On startup, CinePro Core prints a banner with a ready-to-use link of the form https://ui.cinepro.cc/?omssurl=<your-instance-url>. The UI is in public testing and contributions are welcome at cinepro-org/ui.

Intended use

CinePro Core is intended for personal, home, and educational use only.
It is not designed or supported for commercial or large‑scale streaming deployments.

• Run CinePro Core on your own hardware (for example, a home server or NAS).
• Treat the codebase as a starting point for your own experiments and custom scrapers.

Do not use CinePro Core as a commercial streaming platform or a hosted content service.
The maintainers do not provide SLAs, scaling guarantees, or legal guidance for production‑grade usage. It is not secure for public hosting by default.

Legal and content responsibilities

CinePro does not host content

CinePro Core does not host, upload, or store any video files.
It only discovers and aggregates links that are already publicly available on third‑party sites.

• You are solely responsible for how you use CinePro Core and which providers you enable.
• Ensure that your usage complies with all applicable laws and regulations in your jurisdiction.

Nothing in this documentation constitutes legal advice. If you are unsure whether your use of CinePro Core is lawful, consult a qualified legal professional before proceeding.

Next steps

Get started quickly

Install dependencies, configure your TMDB API key, and run CinePro Core locally in a few minutes.

Explore the API

Learn how the OMSS‑style HTTP API is structured and how to fetch movie and TV show sources programmatically.