← WidemileCONTENT HISTORY
WHAT CHANGED
Update to Widemile
Snapshot Oct 29, 2026 · 00:05 UTC · version 1.2.0
Collection source: downloaded plugin package.
First saved snapshot
No earlier snapshot is available to establish a change.
Save Widemile and check future changes in Following.
Up to 3 plugins free · no card required.
Compare saved observations
Download comparison JSONFull technical diff · 0 changed fields
Full snapshot data
{
"description": "Animate editable property keyframes with easing and Bézier curves; track a person, face or object in existing footage, reframe automatically, attach titles to the subject or place them behind its silhouette, and style editable Composer text with curves, depth and staggered animation.",
"included_files": [],
"name": "composer-motion",
"skill_md_contents": "---\nname: composer-motion\ndescription: Animate editable property keyframes with easing and Bézier curves; track a person, face or object in existing footage, reframe automatically, attach titles to the subject or place them behind its silhouette, and style editable Composer text with curves, depth and staggered animation.\n---\n\n# Composer motion\n\n## Tool requirements\n\n- **Core:** `prostudio_editor_get`; for analysis and binding, `prostudio_composer_tracking_create`, `prostudio_composer_tracking_get`, `prostudio_composer_tracking_apply`.\n- **Source evidence:** `prostudio_composer_media_catalog_get`, `prostudio_composer_media_inspect`.\n- This declaration does not activate tools. If operations are missing and `load_prostudio_tools` is available, retrieve the required capabilities before claiming they are unavailable.\n\n## Read and select\n\nRead `prostudio_editor_get` with the exact timelineId and the available text contract: `prostudio_editor_guide_get` on MCP, or the published Editor surface contract on the web Agent. Select stable clipIds and catalogue assetIds from returned evidence. If tools are missing, retrieve them with `load_prostudio_tools` when available. Never invent property names after validation failures: read the canonical schema first.\n\nUse `prostudio_composer_media_catalog_get` and `prostudio_composer_media_inspect` to identify the source and subject. Prefer a precise target such as person, face or red car. An optional normalized point selects one instance in the first analysed frame. This is subject segmentation and position tracking; it does not solve a 3D camera, track a planar surface or identify the active speaker from audio.\n\n## Editable property keyframes\n\nUse the published Editor schema and current clip state. `set_clip_properties` / `prostudio_editor_set_clip_properties` accepts `patch.motion`, which replaces all motion tracks: merge with existing tracks to preserve unrelated animation. `motion=null` removes animation. Visual clips support x/y (canvas percentage offsets), scale (0.1–5), rotation (degrees), opacity (0–1), anchorX/anchorY (0–100 percent within the layer). Images and videos also support cornerRadius (0–4096 sequence pixels) both as a static transform field and a motion track. It rounds the visible cropped media rectangle, clamped to half its smaller dimension; do not put it on text/audio clips. Extended static properties also live in transform.\n\nEach track is a strictly increasing array of `{frame,value,easing?}`. Frame is an integer relative to the untrimmed clip at sequence FPS: sourceFrame = timelineFrame - clip.startFrame + clip.trimStartFrame. Moving a clip preserves its relative motion; trims/splits retain phase; changing FPS rescales keyframes. Keys outside the visible range may be intentionally retained for split/trim continuity. Easing is on the outgoing segment: linear, hold, ease-in, ease-out, ease-in-out, or `{type:\"bezier\",x1,y1,x2,y2}`. Bézier x controls stay in 0–1; y controls can overshoot within published bounds. Inspect the complete animated interval before export. Frame values before the first/after the last key hold that key's value.\n\nFor example, animate x with `[{\"frame\":0,\"value\":-30,\"easing\":\"ease-out\"},{\"frame\":30,\"value\":0}]` while preserving the clip's other motion tracks. Do not send keyframe JavaScript expressions or invent unsupported property names. Ordinary local keyframe editing does not submit footage for tracking analysis.\n\n## Automatic tracking\n\nThe analysis sends footage to the external FAL service. Only set userApproved=true when the human has authorized that processing. Ask once if authorization is missing; reuse authorization in the current task. Analyse the source interval needed by the selected clip, up to 3600 seconds per job. Reuse one UUID idempotencyKey and identical arguments after uncertain submission. Never automatically start another paid attempt after failure or an uncertain dispatch.\n\nCall `prostudio_composer_tracking_create`, wait with `prostudio_composer_tracking_get` until terminal, and inspect coverage and sampled positions. Read more sample pages if useful. A missing detection remains missing; a stable object identity is retained rather than switching people. Poor coverage requires visual inspection and an honest limitation, not invented positions.\n\nApply a completed job through `prostudio_composer_tracking_apply` with current expectedVersion, exact videoClipId and optional textClipId. Modes are reframe, text-follow, text-behind and text-follow-behind. Put the text track above the video. The job must match that source and cover its visible source interval. Text transform remains an offset from the subject; behind mode uses its per-frame silhouette. Preserve existing captions, audio and unrelated effects. Trims, moves, splits and FPS changes use source time. Re-read after a version conflict. Saved undo can restore the prior binding.\n\nFor social clipping, load social-clipping, create or reuse a tracking job covering the excerpts, and supply framing=track plus trackingJobId on each relevant clip. The batch waits for tracking and transcription before rendering. Use contain when requested or when the tracked composition is unsuitable.\n\n## Editable advanced typography\n\nText shadows use `patch.text.shadow` (boolean) and `patch.text.shadowOpacity` (0–1 intensity). Omitting intensity preserves the legacy 0.55 alpha. Turning shadows off retains their saved intensity. These values are shared by preview and export.\n\nUse the live ClipText schema. Effects belong in `patch.text.effects`, not clip-level effects or invented flat text fields. Web Agent installations may expose a batch command tool with a set_clip_properties command; MCP exposes `prostudio_editor_set_clip_properties`. Use the tool actually present and its returned version.\n\nExample effects object (preserve any existing binding and unrelated values):\n\n```json\n{\n \"path\": {\"kind\":\"wave\",\"amount\":0.25,\"cycles\":1},\n \"depth\": {\"pixels\":20,\"angle\":45,\"color\":\"#243218\",\"rotateX\":0,\"rotateY\":-10,\"rotateZ\":0,\"perspective\":1200},\n \"animation\": {\"unit\":\"character\",\"preset\":\"pop\",\"durationSeconds\":0.4,\"staggerSeconds\":0.06,\"easing\":\"ease-out\"}\n}\n```\n\nPaths support arc, wave and cubic bezier; bezier needs four normalized control points. Amount controls bend strength. Depth is projected 2.5D extrusion with perspective tilt, not a physical 3D mesh. Optional stroke and letterSpacing use sequence pixels. Animation supports word or character units and reveal, rise, pop or rotate presets. Read bounds from the schema. Use effects=null to reset all effects; omit a field from a complete replacement effects object to remove just that effect, preserving any others. Use tracking=null on the video to remove its automatic tracking; remove binding from the text effects to detach it.\n\n## Aspect ratio and resolution\n\nRead the actual sequence width/height/fps and inspect beginning/end source frames before positioning text. Native source dimensions are not the output canvas. With contain, map the source into its centered fit and use available side space deliberately; with crop/reframe, reason about the visible cropped canvas. Font size is in output pixels; transform x/y are percentages from the canvas center. Never reuse a pixel font size blindly between 720p, 1080p and portrait canvases. Choose line breaks, font size and offsets for the available width, leaving room for the full motion path, curve, stroke and extrusion. Keep the face clear and titles recognizable behind the silhouette. Changing aspect ratio needs another layout review. Captions can use layout=caption for bounded automatic wrapping. Ordinary creative titles keep explicit layout freedom and need visual verification.\n\n## Verify and deliver\n\nBefore exporting, call `prostudio_composer_media_inspect` with timelineId, expectedVersion and representative timestamps to see the composed result, not only the source. Check textVisibility.visibleFraction and the actual pixels. If the title is mostly hidden, revise placement, line breaks or size and preview again. A tight close-up may leave no readable room behind the subject: use a foreground title or a separate foreground subline, while retaining subject following. Native portrait can use a large hero behind the head plus a smaller foreground subline on separate tracks. A title inside the frame can still be unreadable under the silhouette. Use real newline characters for line breaks, not literal backslash-n text.\n\nExport the exact saved timeline version with a stable UUID using `prostudio_editor_export`, poll `prostudio_job_status`, and preview the real result. Check first/middle/last frames, hair/hand edges, moving masks, title readability, source/audio timing and any edited boundaries. A completed export alone is not evidence of visual quality. If required, run separate demonstrations for reframe, curves/depth, occlusion and tracking after a trim/split/FPS change. Preserve successful results when another demo fails. Deliver editable timelineIds and real previews; state remaining limitations accurately.\n"
}SHA-256 of public snapshot: 6f4f480fa4462fa32114668be6edccfdff8f73bc54ebeef7a9a556693cc9706c