Skip to main content
CinePro Core is currently in active development and considered alpha software.
Expect breaking changes and incomplete features as the OMSS‑compliant TypeScript backend evolves.

​
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 experimental frontends and CineHome, by exposing a shared HTTP API and data model.

​
Key features

Modular providers

Add and maintain multiple streaming providers behind a single API.
Providers live in the src/providers directory and can be extended without changing the core server.

Type‑safe architecture

Implemented fully in TypeScript with strict typing, giving you safer refactors, clearer contracts, and better editor tooling.

Caching & performance

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

Docker‑ready deployment

Ship CinePro Core with Docker or Docker Compose, including optional Redis, using the provided Dockerfile and compose configuration.

Multi‑source media

Fetch movie and TV show sources from multiple third‑party providers through a single OMSS‑style API, instead of integrating each site separately.

CineHome integration

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

​
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.