Ymotion
Help
Docs Connect a chatbot
Dashboard
All pages

Documentation

Ymotion docs

How to drive Ymotion, a 2D motion-graphics engine, from a chatbot over MCP: the tools, the units, and guides to captions, type, motion, colour and sound.

These are the pages a chatbot reads when it drives Ymotion over MCP — it opens them with ymotion_help {"topic":"docs"} — and they are written to be read by people too. Each page stands on its own, so open whichever one covers what you need.

Getting started

  • Getting startedWhat Ymotion is, what each tool is for, and a first film from an empty document to a frame you can look at.
  • Documents and projectsStarting, opening and saving films; projects, and how every save is kept; undo; several documents at once; and removing saved work.
  • Searchable detailsOptional descriptions that help later chats find projects, uploaded files and exports by words.
  • Images and designsPictures instead of films — a post, a poster, a grid or a carousel — one canvas cut into pieces, exported as PNG, JPEG or WebP.
  • Units, paints and timeHow positions, sizes, type, angles, time and colours are written, and why nothing is in pixels and nothing is random.
  • Looking at your workRead the timeline, render export frames, inspect a stretch or storyboard, and measure the sound before saying a change worked.
  • Exporting a filmShow the person the film with a preview link, or queue an mp4 of all or part of it, follow it, share it and remove it.
  • What the measurements meanEvidence, finding thresholds, pending work and client limits for frames, sheets, timelines and measured sound.

Footage and sound

  • Footage, images and the libraryFind the person's uploads, place video, pictures and sound on the timeline, and reframe footage for any shape of film.
  • Getting a file inHow a file reaches the person's uploads from a chat, by attachment, link or base64, and how to describe it so it can be found again.
  • What an upload saysWord-timed transcripts of uploaded sound, how to read them a passage at a time, and how to turn their times into timeline times.
  • Beats in soundThe tempo, beats, downbeats and accents of an uploaded sound, found when it arrives, and how to cut, title and time sound to them.
  • Putting things behind a personCut a person or any object out of footage or a photo as one layer, so titles sit behind it — and see the selection first.
  • Sound, music and sound effectsBring in music and voice, set levels in decibels, fade, pan and process sound, place library sound effects on a cut, and check the mix.

Guides

  • CaptionsCaptions from a transcript: phrasing, timing, one layer per phrase, placement, legibility, emphasis and word-by-word highlights.
  • Formats and layoutChoosing a canvas shape, safe areas on vertical video, margins and hierarchy, and placing layers exactly by measuring them.
  • Type and titlesChoosing a face, sizing and spacing type, point and paragraph text, styled runs, outlines and shadows, and type on a path.
  • Text animators and presetsAnimating type by character, word or line with animators and selectors, and the text presets that are built from them.
  • Keyframes and easingHow keyframes work on a layer's own clock, the verbs that write them, easing and speed, loops, wiggles, motion paths and parenting.
  • Cuts and transitionsPutting a transition on the cut between two shots, how the overlap is made, and when a straight cut or a hand-built dissolve is better.
  • Sound effects for motionWhich library sound suits which animation — typing under a typewriter, a whoosh on a zoom, a shutter on a transition — and how to time it.
  • Compositions and nestingMaking compositions, placing one as a layer, editing inside it, pre-composing layers, and how a nested comp's size, time and sound behave.
  • TemplatesPrebuilt animations, such as a chat, a notification or a chart, placed as one composition whose values can be changed later.
  • Templates that moveHow every template's values take keys, how each part arrives, leaves and loops, and the background, placement and cursor every template has.
  • Colour and gradingGrading with the filter stack, from exposure and curves to lift, gamma and gain, plus legible type over footage and palettes.
  • Effects, blur and layer stylesBlurs, distortions, glow and strobe, layer styles, blend modes and motion blur: what each does, what it costs and how to animate it.
  • Shapes, icons, masks and mattesShape layers and their trees, icons, solids and gradients, masks and track mattes, with recipes for bars, highlights and vignettes.

Reference

  • RecipesThe call shapes for common jobs — titles, fades, lower thirds, logos, sound on a cut, crops, transitions, looks and captions.