cineparc

cineparc is a self-hosted media server. You point it at a folder of videos. It catalogs them, fetches movie and TV info from the internet, and lets you watch them in your browser.

Run with npx

Needs Node.js 24 or newer. (yt-dlp is optional, only for downloading YouTube videos.)

npx @cineparc/cli serve

The first run in a folder with no config asks you a few questions and writes a config.json. After that it starts the server and watches your folder. Open the printed URL, by default http://localhost:3000.

Run from source

Needs Node.js 24 or newer.

git clone https://github.com/dalie/cineparc.git
cd cineparc
npm install

Option A — dev servers (for hacking on it)

Two terminals. The API watches your folder and does the first-run setup. The UI is a dev server with hot reload that talks to the API.

npx nx serve @cineparc/api

npx nx serve @cineparc/ui

Open the URL the UI dev server prints.

Option B — build and run like the published package

One process, no hot reload, closest to the npx experience.

npx nx run @cineparc/cli:package
node apps/cineparc/dist/dist/main.js serve

License

MIT