Workshop Documentation

Workshop compiles human-readable .ws files into professional motion graphics videos. Write what you want to say, choose a mood, and the compiler handles typography, timing, animation, and layout.

Workshop is a hosted API. You send .ws source over HTTPS, we return video.

Get Started

Write your first video — go from zero to a rendered MP4 in under five minutes. All you need is an API key. Start the Quickstart →

Explore the language — learn how .ws files work: scenes, moods, layouts, entrances, timing. Read the Language Overview →

Integrate the API — compile, render, manage templates and themes programmatically. View the API Reference →

How It Works

A .ws file has two parts: a Film block for global settings and Scene blocks for each screen of your video.

text

Film "Product Launch"
  mood: confident

Scene "Problem"
  show "Your tools are slowing you down."
    size: title
    enter: rise

Scene "Solution"
  show "Not anymore."
  beat 1.2s
  show "Meet Apex."
    size: hero
    emphasis: "Apex"

Scene "CTA"
  show "Start free at apex.dev"
    size: display
    color: accent

Send this to the Workshop API and get back a polished motion graphics video — deterministic, brand-safe, and ready for delivery.

Key Concepts

Moods — a single word controls palette, typography, timing, easing, and animation across your entire video. Six moods, five variants each, 30 visual identities.

ThemePacks — encode your brand as JSON. Every video compiled with your ThemePack is on-brand by construction.

Templates — define a scene layout once with variables, fill it thousands of times. One template plus a CSV equals a batch render.

Determinism — same .ws input produces byte-identical output. Version-controllable, diffable, approvable.