Pixfabrica

A browser-based motion graphics editor for short-form video. Stack pre-built animated clips on a timeline, tune them lightly, and render to MP4.

Licensed under MIT.

What you get

• Timeline editor with platform presets (YouTube Shorts, TikTok, Reels, and more)
• Plugin clip library - backgrounds, dynamic text, audio-reactive visuals, effects
• Live preview and MP4 export via FFmpeg
• Optional compose agent when Ollama is available (local / Docker profile)

Develop locally (recommended)

Use this path for realtime preview and GPU / OpenGL. On Windows and macOS it is the supported way to get gl.available: true.

Windows

doctor.bat
setup.bat
run-all.bat

macOS / Linux

chmod +x doctor.sh setup.sh run-all.sh
./doctor.sh
./setup.sh
./run-all.sh

Opens the editor at http://localhost:5173 (API on 8000).

Tool	Required
Python 3.12 + uv	yes
pnpm	yes
FFmpeg	recommended (required for export)
Ollama	optional (compose agent)

See CONTRIBUTING.md for tests, lint, and PR expectations.

Pinokio

1-click install via Pinokio:

pterm download https://github.com/AlexNolasco/pixfabrica.git pixfabrica.pinokio.git

Then Install and Start & Open Editor in the Pinokio UI. Click Open Editor when it appears. Opens the editor at http://localhost:5173 (API on http://localhost:8000). Details: pinokio/README.md.

Docker (optional)

Docker Compose packages the editor + API without installing uv, pnpm, or FFmpeg on the host. It is a good fit for Linux demos and VPS-style hosts.

It is not the path for Windows/macOS GPU Play: Docker Desktop often stays on software GL (llvmpipe). Use run-all above when you need realtime OpenGL.

CPU / Skia demo at http://localhost:8080:

cp docker/.env.example docker/.env
docker compose --env-file docker/.env -f docker/compose.yml up --build

NVIDIA GPU (Linux + NVIDIA Container Toolkit):

docker compose --env-file docker/.env \
  -f docker/compose.yml -f docker/compose.gpu.yml up --build

Confirm http://localhost:8080/api/health → gl.available: true and a real NVIDIA renderer. Full details: docker/README.md.

Documentation

Topic	Link
Architecture and design	docs/ARCHITECTURE.md
API	api/README.md
Web UI	web/README.md
Plugins	plugins/README.md
CLI	cli/README.md
Roadmap	docs/ROADMAP.md

Repo layout

Package	Role
core/	Shared models - graph, audio bus, theme, plugin protocol
api/	FastAPI - jobs, preview, gallery, render queue
renderer/	Skia CPU + GPU render engine
plugins/std/	Built-in clip library
web/	React timeline editor