Skip to content

explainroo 0.6

Latest

Choose a tag to compare

@vincentsch vincentsch released this 10 Nov 14:12

explainroo 0.6 records your real app. The agent writes the clicks and the typing as steps, explainroo plays them in a browser of its own, and a scene shows that recording with a cursor and zooms that land on the narration. New projects start in a new look, and formats give a video of one kind a ready shape.

Tell your coding agent: "Use explainroo for it: run npx --yes explainroo docs and follow what it prints."

Record the real app

  • explainroo record <project> <name> runs recordings/<name>.json in a clean browser and saves the video with a log of every step.
  • Steps click and type like a person. A zoom step brings the camera close, and a mark names a moment for the narration.
  • record --inspect <url> lists the buttons and fields of a page with a selector for each one, so the agent never has to guess what a page holds.
  • s.recording() plays the recording in a scene. A step with a cue happens on its word, and the recording waits for the narration when it has to.
  • The browser asks the site for the project's language, so an English video shows an English site.
  • check warns when the page's text would play too small on a phone, and names the viewport that fixes it.
  • blur hides email addresses and keys on every page. When a page keeps a secret sharp anyway, record stops and keeps no video.

A new look and formats

  • New projects start in studio, a light look where every title and card follows one size scale.
  • A format is a ready way to make one kind of video, with a guide for the agent and an example. Four come with explainroo:
    • product-launch
    • product-ad
    • narrated-explainer
    • vertical-short
  • explainroo init videos/x --format product-ad starts a video from a format.
  • Anyone can publish a format in a Git repository. explainroo formats add <address> shows what it will run before it installs it.
  • The list of sizes moved from explainroo formats to explainroo sizes.

Tall videos

  • In Shorts, TikTok and Reels, pictures may now fill the whole frame. Text stays in the safe area.
  • The short kit keeps its stickers off titles and pictures, and its words follow the video's language.
  • check finds text under the watermark, also when the camera zooms in.

Any video, and your own recordings

  • check and verify take a video made with any tool. They report:
    • blank and frozen stretches
    • silence and loudness
    • text too small for a phone
    • with --script, the words of your script the speech model didn't hear
  • explainroo cut talk.mp4 writes the words of your recording with their times. Delete words and pauses in that file, and cut --apply writes the shorter video with clean joins.
  • still and sheet show frames of any video file, also a phone video shot upright.
  • s.clip plays part of a file with from and to. crop cuts a clip or an image to the part you need.

Languages and the speech check

  • In Spanish and French, and also in Italian and Portuguese, the speech check reads spelled numbers as digits.
  • It reads an amount like R$ 100 as "cem reais", and the same goes for dollars and euros.
  • It treats "un'ape" and "un ape" as the same word.
  • When a word can't be confirmed, the advice quotes the text the voice was given. A "heard" line in video.json accepts a word that is said right but heard another way.
  • s.number writes numbers the way the video's language does, like 1 050 in French.

Presenters

A presenter is a clip of a talking person next to your product. explainroo has the connector for presenter services, with a consent rule: no real person's face or voice without that service's own consent flow. Every video with a presenter carries an AI label. No service is built in yet. When a service gives no price for a clip, presenter buys nothing.

Fixes

  • When a posting service echoed your key back in an error, publish could show it in its output and save it in history/. It now hides the key everywhere it writes, and so does every other command that shows a service's error. explainroo 0.5 had the same problem, so update to 0.6 if you post with it.

Older projects keep their look

A project made before keeps its frames until you add "defaults": "0.6" to its video.json. init writes it into every new project. One fix applies to every project: the zoom transition no longer shows the frame drawn before it.

The full announcement is on explainroo.com.