OPENVIDEO
Documentationopen-video.appGitHub ↗
LanguageEnglish한국어

Install and run

Prerequisites, cloning the repository, pointing OpenVideo at your FFmpeg, and verifying the build from source.

Prerequisites

  • Node.js 22 or newer and npm 10 or newer
  • FFmpeg on your machine — required for MP4 export
  • macOS only: Screen Recording permission for the terminal running OpenVideo, if you use window capture

Clone and run

git clone https://github.com/Theorvane/openvideo.git
cd openvideo
npm install
npm run dev

npm run dev starts the Electron app with the renderer in development mode. The first launch opens the start page, where you pick a folder to open as your first project.

Pointing at your FFmpeg

OpenVideo drives the FFmpeg you installed rather than bundling its own. Either make ffmpeg discoverable through an absolute directory on PATH, or name the binary explicitly:

VIDEO_TOOL_FFMPEG_PATH=/absolute/path/to/ffmpeg npm run dev

Running the agent with no cloud account

A local Ollama engine needs no key, no account, and no network call:

ollama pull qwen2.5-coder
ollama serve

Then choose the local model in the chat panel's model picker. Note that watching footage needs a vision-capable model — see Providers and models.

Verify from source

npm run typecheck
npm test
npm run build

npm run build compiles the main, preload, and renderer bundles into out/. It does not package an installer. Some behaviour can only be checked by hand: operating-system permissions, real provider calls, and final render quality.