Skip to content

explainroo 0.5.0

Choose a tag to compare

@vincentsch vincentsch released this 09 Nov 08:10
· 217 commits to main since this release

explainroo 0.5 runs with npx, so you don't have to clone it. It can also use outside services on your own key or login, like AI video clips and posting to your channels. A whole video still needs no account and no key.

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

Run it with npx

  • npx --yes explainroo docs prints a short start page for coding agents. docs <topic> prints one topic, and docs <topic> <section> prints one part of it, so an agent reads only what it needs.
  • Every command has its own --help. The examples come with the package, and doctor shows where they are.
  • explainroo set <project> <key> <value> changes one setting in video.json, and it checks the value first.

Outside services on your own key

  • explainroo services lists the choices for each step, with the free ones first. Each one says what it costs and what leaves your computer. explainroo connect tests a key or a sign-in and saves it.
  • explainroo clip buys short AI video clips through OpenRouter. It shows the price first, and "clipBudget" in video.json sets one budget for all the clips of a video. The final cost is known after the job and can come out a little higher than the price.
  • explainroo package writes a folder for one platform: the video at the right size, the post text, captions, a cover and an AI label.
  • explainroo publish posts a package after a dry run and a yes. It posts to YouTube directly, or through Buffer and Blotato for the other platforms. With --draft, Buffer keeps the post as a draft.
  • Buffer takes no file upload, so it needs a public link to the video. publish checks that the link leads to a file of the same size before it posts.
  • A project keeps a record of what was paid for and posted in its history/ folder. The same request uses the file it already bought, and a post never goes out twice. explainroo history shows the record.
  • explainroo share will give a video a page on explainroo.com. That service doesn't run yet, so for now the command says so and sends nothing.

Voices and languages

  • German narration works with ElevenLabs, with Cartesia, or with your own recording. Kokoro has no German voice.
  • doctor --language es checks what a language needs before you have a project. On Debian and Ubuntu, doctor --fetch --language es sets up espeak-ng without root.
  • One project can make the same video in several languages, with a script for each.

Length and timing

  • "targetSeconds" in video.json gives a video an exact length. voice --estimate prints the expected length before anything is made.
  • explainroo words lists the spoken words of a scene with their times, for picking cues. A cue like 'fills#2' means the second time a word is spoken.
  • Moving a marker no longer makes the narration again.

Short videos and sizes

  • "sizes" in video.json gives one size settings of its own, like bold captions and a quicker pace for TikTok only. --platform tiktok on check, still, sheet and render shows each frame the way the TikTok package will.
  • "captions": "bold" shows two to four big words at a time. s.short draws a hook title that is there on the first frame.
  • A cover change no longer needs a new render.

Checks

  • check now sees shapes and arrows. It finds shapes that partly cover each other, and lines or text that run through a shape. It also finds text cut at the frame edge while the camera holds, typing that never finishes, and stretches where the screen is empty. Warnings name the element.
  • The speech check accepts words that sound the same, two words heard as one, units like "km/s", and numbers written in another style. It lists the words it only nearly heard, with their times. voice quotes what it heard for any word it couldn't confirm.
  • render keeps the sound at -1 dBTP or lower, and verify fails a video that clips. verify ends with one line that says whether the video passed.

Older projects keep their look

A project made before 0.5 keeps its look, frame for frame, until you add "defaults": "0.5" to its video.json. The line brings the new look: bigger arrow labels, a camera that keeps attached arrows in the shot, and a cover chosen from the fullest frame of the first scene. init writes it into every new project.

The full announcement is on explainroo.com.