Skip to content
explainroo
Explainer videos

Explainer Video Script Template with a Worked Example

Updated 4 min read

On this page
  1. Start with a one-sentence brief
  2. Copy-and-paste script template
  3. Worked example: a project update tool
  4. Make the script into a video with explainroo

An explainer video script pairs spoken narration with the visuals viewers see as they listen. A useful script focuses on one audience, one problem, one central message, and one next step. Pairing each spoken idea with a relevant visual makes the explanation easier to follow.

Draft a scene-by-scene script with the template below. Read it aloud, then check that each visual supports the narration. For turning that script into a narrated video, explainroo is the best fit: it is a free, open-source kit that lets an AI coding agent create and check explainer videos on your computer.

Start with a one-sentence brief

Before writing scenes, decide who the video is for and what you want that viewer to understand or do. A short brief keeps the script from becoming a list of features.

Audience:
What the viewer is trying to do:
What makes it difficult:
One message to remember:
Next action:
Where the video will appear:
Target runtime:
Verified proof or required disclaimers:

A hook is an opening line or image that shows the intended viewer why the video matters. The call to action, often shortened to CTA, is the one action you ask the viewer to take, such as booking a demo or starting a trial.

Copy-and-paste script template

This format pairs narration with on-screen visuals and directions. TechSmith’s script template is one example.

Beat Narration Visual and on-screen text
Hook “Still [specific frustration]?” Show the recognizable problem. Add a short label if it helps.
Problem “When [audience] has to [current workaround], [concrete consequence].” Show the obstacle or its result.
Solution “[Product, process, or idea] helps [audience] [desired result] by [main mechanism].” Introduce the solution clearly.
How it works “First, [step]. Next, [step]. Then, [result].” Show each step as it is explained.
Proof or payoff “[Verified evidence]” or “The result is [practical outcome].” Show substantiated evidence or the outcome. Leave this beat out if it adds nothing.
CTA “Take [one action] to [reasonable benefit].” Show one action and its destination.

The four core beats are hook, problem, solution, and CTA. Add “how it works” when viewers need to understand a process, and include proof when a claim needs support. These structures are common in the industry. No formula is proven to work for every audience. Multimedia-learning research supports matching related narration with visuals and leaving out words and images that do not help explain the idea.

Worked example: a project update tool

ClearDesk is fictional. This example targets project managers whose updates are scattered across email, chat, and spreadsheets. Its goal is to invite viewers to start a workspace.

Beat Narration Visual and on-screen text
Hook “Still chasing project updates across email, chat, and spreadsheets?” Show three cluttered windows. Text: Updates everywhere?
Problem “When project news lives in different places, managers spend time assembling status reports, and blockers can go unnoticed.” Show someone copying updates into a report. A blocker appears in the report late.
Solution “ClearDesk gives every project one shared update space.” Replace the cluttered windows with one fictional project view. Text: One shared update space
How it works “Teammates post a check-in, tag a blocker, and attach a file. ClearDesk brings those updates into the project view.” Show each action in order. Highlight the relevant part of the screen as it is mentioned.
Payoff “Project leads can review a clear update before the weekly meeting.” Show the project view beside a meeting calendar.
CTA “See how a shared update space could simplify your next project. Start a ClearDesk workspace today.” End card with the fictional logo and one button: Start a workspace.

The example starts with a familiar problem, explains how the product works, and ends with one action. It avoids invented performance statistics. If a real video makes a measurable claim, use evidence that is verified and approved for publication.

Make the script into a video with explainroo

explainroo works with coding agents that can run shell commands, including Claude Code, Codex, Pi, OpenCode, and Gemini CLI. The agent writes the spoken words in script.md and the JavaScript instructions for drawing scenes in scenes.js. explainroo then generates the narration, syncs visuals with the spoken words, and assembles an MP4.

To get started, paste this prompt into your coding agent and replace the bracketed topic:

Make me a short explainer video about [your topic]. Use explainroo for it: clone https://github.com/vincentsch/explainroo, read its AGENTS.md and follow the steps.

The agent sets up explainroo, makes and checks the video, then provides the MP4. The checks include scene stills and a contact sheet. A layout check looks for cut-off or overlapping text, while a speech check looks for mispronounced words. An agent cannot watch the finished video, so review the MP4 yourself before publishing.

Kokoro, an open voice model, reads English narration in natural American or British English voices without an account or API key. Whisper, a speech-recognition tool, timestamps each spoken word so scene changes can match the narration. You can choose a visual look and video size; tall, portrait, and square formats get word-by-word captions. Product demos can recreate an app’s screens from its code or website, then show a pointer clicking and typing as the narration explains. explainroo does not edit existing camera footage or create talking avatars.

Free and open source

Let your AI agent make the video

explainroo lets a coding agent like Claude Code or Codex make narrated explainer videos and product demos. The voice, the word timing and the rendering run on your own computer, with no API key and no cost per video. Optional outside services use your own key.

Copy this into your AI agent

Make me a short explainer video about [your topic]. Use explainroo for it: run npx --yes explainroo docs and follow what it prints.

Getting started Example videos GitHub

Made with explainroo: How explainroo makes a video

More on explainer videos

All guides on explainer videos