Skip to content

Explainer videos and product demos made by your AI agent. Free and open source: a local voice (Kokoro), word timing (Whisper) and a canvas renderer turn a script into a narrated MP4.

README: looks and sizes shown with frames from real example videos, light and dark versions, no black box

Vincent Schmalbach9b95bf67ad11
diff --git a/README.md b/README.md
index c462e40..aded304 100644
--- a/README.md
+++ b/README.md
@@ -85,16 +85,29 @@ OpenRouter. That is optional, and you pay per image.
## Looks, sizes and pace
+There are five looks: paper, clean, chalk, blueprint and midnight. These are
+frames from example videos, one in each look. The same video works in any of
+them.
+
+<p align="center">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="docs/media/looks-dark.webp">
+ <img src="docs/media/looks-light.webp" alt="Frames from five example videos, one in each look: paper, clean, chalk, blueprint and midnight" width="820">
+ </picture>
+</p>
+
+Each video gets the size of the place it goes. There are sizes for YouTube,
+YouTube Shorts, TikTok, Instagram Reels, Instagram and LinkedIn feed posts,
+and a square one. On Shorts, TikTok and Reels, explainroo keeps the text away
+from the buttons the app puts on top of the video.
+
<p align="center">
- <img src="docs/media/looks.jpg" alt="The same diagram in the paper, clean, chalk, blueprint and midnight looks" width="720">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="docs/media/sizes-dark.webp">
+ <img src="docs/media/sizes-light.webp" alt="Frames from example videos in four sizes: YouTube 16:9, TikTok 9:16, LinkedIn 4:5 and square" width="820">
+ </picture>
</p>
-- **Five looks.** Paper, clean, chalk, blueprint and midnight. The same video
- works in each of them.
-- **Sizes.** There is a size for YouTube, YouTube Shorts, TikTok, Instagram
- Reels, Instagram and LinkedIn feed posts, and a square one. On Shorts,
- TikTok and Reels, explainroo keeps the text away from the buttons the app
- puts on top of the video.
- **Pace.** Set `pace` to 1.2 and the whole video gets 20% quicker. That
includes the voice, the pauses and each animation.
- **Captions.** They light up word by word. You get them for vertical, 4:5
diff --git a/docs/media/looks-dark.webp b/docs/media/looks-dark.webp
new file mode 100644
index 0000000..ce4ddc1
Binary files /dev/null and b/docs/media/looks-dark.webp differ
diff --git a/docs/media/looks-light.webp b/docs/media/looks-light.webp
new file mode 100644
index 0000000..71da9cb
Binary files /dev/null and b/docs/media/looks-light.webp differ
diff --git a/docs/media/looks.jpg b/docs/media/looks.jpg
deleted file mode 100644
index 608f557..0000000
Binary files a/docs/media/looks.jpg and /dev/null differ
diff --git a/docs/media/sizes-dark.webp b/docs/media/sizes-dark.webp
new file mode 100644
index 0000000..9d7fddb
Binary files /dev/null and b/docs/media/sizes-dark.webp differ
diff --git a/docs/media/sizes-light.webp b/docs/media/sizes-light.webp
new file mode 100644
index 0000000..23644af
Binary files /dev/null and b/docs/media/sizes-light.webp differ