Repository navigation
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>runsrecordings/<name>.jsonin 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.
checkwarns when the page's text would play too small on a phone, and names the viewport that fixes it.blurhides email addresses and keys on every page. When a page keeps a secret sharp anyway,recordstops 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-launchproduct-adnarrated-explainervertical-short
explainroo init videos/x --format product-adstarts 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 formatstoexplainroo 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.
checkfinds text under the watermark, also when the camera zooms in.
Any video, and your own recordings
checkandverifytake 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.mp4writes the words of your recording with their times. Delete words and pauses in that file, andcut --applywrites the shorter video with clean joins.stillandsheetshow frames of any video file, also a phone video shot upright.s.clipplays part of a file withfromandto.cropcuts 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$ 100as "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 invideo.jsonaccepts a word that is said right but heard another way. s.numberwrites numbers the way the video's language does, like1 050in 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,
publishcould show it in its output and save it inhistory/. 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.