winget install --id=iLoveVideoEditor.CLI -e Official CLI for iLoveVideoEditor — queue video renders from VideoJSON specs, check render status, estimate credit cost and list the 249+ public templates. Requires an API key from the iLoveVideoEditor dashboard.
Official CLI for iLoveVideoEditor — render videos from VideoJSON specs in your terminal or CI/CD pipeline.
export ILOVEVIDEOEDITOR_API_KEY=vf_live_...
npx ilovevideoeditor render video.json -o out.mp4
# Homebrew (macOS & Linux)
brew tap ilovevideoeditor/tap
brew install ilovevideoeditor
# Scoop (Windows)
scoop bucket add ilovevideoeditor https://github.com/ilovevideoeditor/scoop-bucket
scoop install ilovevideoeditor
# winget (Windows) — pending microsoft/winget-pkgs#402460
winget install ilovevideoeditor
# Docker (Docker Hub or GHCR — multi-arch: amd64 + arm64)
docker run --rm -e ILOVEVIDEOEDITOR_API_KEY -v "$PWD:/work" \
ilovevideoeditor/cli render video.json -o out.mp4
# or: ghcr.io/ilovevideoeditor/cli render video.json -o out.mp4
# Arch Linux (AUR, source-based)
yay -S ilovevideoeditor
# npm (requires Node.js 18+)
npm install -g ilovevideoeditor
# or run without installing
npx ilovevideoeditor --help
Get an API key from the dashboard. All install channels are listed at ilovevideoeditor.com/install.
| Command | Description |
|---|---|
render | Queue a render and wait for the MP4 |
status | Check render status |
estimate | Estimate credit cost before rendering |
templates | List the 249+ public templates |
| Flag | Description |
|---|---|
-o, --output | Download the rendered video to a file |
--no-wait | Queue and exit immediately (returns the job ID) |
--json | Machine-readable JSON output (for CI) |
--search | Filter templates by name/id |
--api-key | API key (env: ILOVEVIDEOEDITOR_API_KEY) |
--api-base | API base URL override (env: ILOVEVIDEOEDITOR_API_BASE) |
Render and download:
ilovevideoeditor render video.json -o promo.mp4
Fire-and-forget (queue only, JSON output for CI):
ilovevideoeditor render video.json --no-wait --json
# {
# "jobId": "425ba18a-dab0-4827-afc9-eec80e5b3c20",
# "status": "queued"
# }
Check status later:
ilovevideoeditor status 425ba18a-dab0-4827-afc9-eec80e5b3c20 --json
Estimate cost before spending credits:
ilovevideoeditor estimate video.json
# cost: 0.04 credits
# duration: 2s
# resolution: 640x360 @ 30fps
Render videos in CI/CD with the official action:
- uses: ilovevideoeditor/render-video-action@v1
with:
api-key: ${{ secrets.ILOVEVIDEOEDITOR_API_KEY }}
spec: video.json
output: promo.mp4
See ilovevideoeditor/render-video-action.
A VideoJSON spec describes the scene: layers, text, images, animations, and timing. Generate one with the fluent API:
import ILoveVideoEditor from '@ilovevideoeditor/core';
const $ = new ILoveVideoEditor({ name: 'Promo', width: 1920, height: 1080, fps: 30 });
$.addText({ text: 'Hello', fontSize: 12, color: '#fff' });
$.wait('3s');
console.log(JSON.stringify(await $.compile()));
@ilovevideoeditor/core — fluent API to build VideoJSON specs@ilovevideoeditor/sdk-node — typed Node.js SDKMIT