effecx

Effecx is a WebGPU-based creative video effects tool focused on fast look development and high-quality exports.

Preview

What it does

• Real-time preview pipeline in the browser with effect controls.
• Luma Depth Matte mode (preview/filter styling controls).
• Effect stack controls (Blur, Sobel Edge, Kinetic Tracer).
• Presets (default + custom saved presets).
• In/Out range workflow with looped playback inside range.
• Export panel with:
  • Quick export (fast iteration)
  • Final CFR export (deterministic deliverable path)
• Export history in the UI with Apply/Retry actions.

Export approach

• Quick: optimized for speed while testing looks.
• Final (CFR): intended for reliable timeline-ready output.

Project structure

• index.html, ui.js, main.js, style.css: frontend app.
• apps/server: backend API, job queues, export pipeline.
• engine/renderer-rs: native renderer components.
• packages/effect-schema: shared effect payload normalization/validation.
• docs: architecture and export contracts.

Local run

1. Install dependencies:
   • npm install
   • npm --prefix apps/server install
2. Start frontend:
   • npm run dev
3. Start backend:
   • npm run dev:server

Backend default: http://127.0.0.1:8787

Known Issues

• If backend routes are from an older server process, /api/export/exact-jobs can return 404.
  • Fix: restart backend with npm run dev:server.
• Quick export in Auto may output WebM instead of MP4 to avoid MP4 timestamp instability.
• Legacy finalize fallback (/api/export/exact-finalize) shows limited real-time stage progress.
• High-resolution Final exports can still be slow based on hardware/codec load.