video-compose 0.5.0

JSON-driven video composition engine for the Trollfabriken FX ecosystem

video-compose

JSON-driven video composition engine for the Trollfabriken FX ecosystem.

Define a presentation or video as a TVCS (Trollfabriken Video Composition Spec) JSON file and render it to MP4 or PNG frames. The JSON can be authored by hand or generated by an AI via the APISuite VideoComposeProvider.

Quick start

pip install video-compose[all]
video-compose render my_presentation.json

Spec example

{
  "tvcs": "1.0",
  "output": { "width": 1280, "height": 720, "fps": 30, "formats": ["mp4"] },
  "theme": { "palette": "neon", "background": "#0d0d1a" },
  "segments": [
    { "id": "intro", "type": "mathviz", "duration": 4.0, "effect": "matrix_rain" },
    { "id": "chart", "type": "chart", "duration": 6.0, "chart_type": "bar",
      "data": { "title": "Revenue", "categories": ["Q1","Q2"], "series": [{"name":"2024","values":[420,580]}] } }
  ],
  "transitions": { "default": { "type": "dissolve", "duration": 0.5 } }
}

CLI

video-compose render   spec.json            Render to MP4
video-compose validate spec.json            Validate without rendering
video-compose preview  spec.json intro      Render single segment
video-compose schema                        Print full JSON Schema

Optional dependencies

Extra	Enables
[mathviz]	mathviz-fx background generators
[chart]	chart-fx animated charts
[geomap]	geo-map-fx choropleth maps
[shape]	shape-fx particle/geometric effects
[fractal]	fractal-fx generative backgrounds
[audio]	talk-cast voiceover + audio-arrange mixing
[data]	CSV, Excel, SQL, REST API data sources
[web]	web-overlay HTML overlays (requires Playwright)
[all]	Everything above

Ecosystem

video-compose is the composition layer for the Trollfabriken FX suite. It orchestrates: mathviz-fx · chart-fx · geo-map-fx · shape-fx · fractal-fx · text-fx · color-fx · cut-fx · talk-cast · audio-arrange · slide-render · still-motion · web-overlay