Manim Video Teacher Skill

A skill package and helper scripts to turn prompts into Manim teaching videos with optional narration, muxing, and cover generation.

Quick start

1. Create a virtual environment and install deps:

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2. Render your Manim scene to a video file (example):

manim -qh your_scene.py YourScene

3. Run the pipeline (TTS + mux + cover):

python manim-video-teacher/scripts/pipeline.py \
  --video media/videos/your_scene/1080p60/YourScene.mp4 \
  --tts-file examples/narration.txt \
  --cover-title "Quadratic Vertex Form" \
  --cover-subtitle "Learn in 60s" \
  --output output.mp4

Scripts

• manim-video-teacher/scripts/tts_generate.py: Generate narration audio with edge-tts.
• manim-video-teacher/scripts/concat_audio.py: Concatenate multiple audio segments.
• manim-video-teacher/scripts/mux_av.py: Mux audio and video into a single MP4.
• manim-video-teacher/scripts/make_cover.py: Generate a simple 16:9 cover image.
• manim-video-teacher/scripts/pipeline.py: One-click pipeline for TTS, mux, and cover.

Requirements

• Python 3.10+
• ffmpeg (installed and on PATH)

Skill installation

Install the skill by placing the folder under your skills directory:

./scripts/install_skill.sh --dest /path/to/skills

If you are using Codex and have $CODEX_HOME set, you can omit --dest:

./scripts/install_skill.sh

Reinstall with overwrite:

./scripts/install_skill.sh --dest /path/to/skills --force

Preview the resolved install target:

./scripts/install_skill.sh --list

Install into a local ./skills folder in the current directory:

./scripts/install_skill.sh --here

If a ./skills folder already exists, the installer will use it by default.

Examples

• examples/narration.txt: Sample narration text.
• examples/scene.py: Minimal Manim scene to render.
• examples/tts_list.txt: Example ffmpeg concat list file.

Demo script

Run an end-to-end demo (venv + deps + render + pipeline):

./scripts/run_demo.sh

Clean generated files:

./scripts/clean.sh

Skill package

The skill lives in manim-video-teacher/ with its SKILL.md and scripts.

License

Apache License 2.0. See LICENSE.