genart.dev
Plugins

Animation

Keyframe animation, timeline control, and export.

Animation layers for keyframe-based motion with timeline control and video export.

Installation

npm install @genart-dev/plugin-animation

Layer Types

Type IDDisplay NameDescription
animation:timelineTimelineKeyframe timeline controlling parameter animation over time

Properties

animation:timeline

PropertyTypeDefaultDescription
durationnumber5Animation duration in seconds
fpsnumber30Frames per second
loopbooleantrueLoop the animation
easingselect"ease-in-out"Default easing: linear, ease-in, ease-out, ease-in-out
keyframesarray[]Array of keyframe definitions
autoplaybooleanfalseStart playing automatically

Each keyframe in the keyframes array has:

FieldTypeDescription
timenumberTime position in seconds
paramstringParameter name to animate
valueanyValue at this keyframe
easingstringPer-keyframe easing override

MCP Tools

ToolDescription
add_keyframeAdd a keyframe at a specific time for a parameter
set_animationConfigure animation duration, FPS, loop, and easing
export_animationExport the animation as video (MP4/WebM) or GIF

Example

{
  "tool": "design_add_layer",
  "arguments": {
    "type": "animation:timeline",
    "properties": {
      "duration": 10,
      "fps": 30,
      "loop": true,
      "easing": "ease-in-out",
      "keyframes": [
        { "time": 0, "param": "rotation", "value": 0 },
        { "time": 5, "param": "rotation", "value": 180 },
        { "time": 10, "param": "rotation", "value": 360 }
      ]
    }
  }
}