meditation-video

Generate narrated spoken-word videos from scripts using Kokoro TTS and ffmpeg offline.

Updated Sep 21, 2026
One-click install
npx skills add https://github.com/dev-skill-up/ai-skills --skill meditation-video-dev-skill-up
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: meditation-video
Source: https://github.com/dev-skill-up/ai-skills/tree/main/plugins/dev-skill-up/skills/meditation-video
Command: npx skills add https://github.com/dev-skill-up/ai-skills --skill meditation-video-dev-skill-up

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires kokoro-onnx, onnxruntime, soundfile, numpy, cairosvg, and includes references (resource) and assets (resource) components.

What problem does it solve? Producing narrated audio and video content — guided meditations, sleep essays, or narrated documentaries — normally requires paid TTS APIs, a GPU, or manual audio editing. This Skill runs the entire pipeline locally with open-source tools, from writing the script to delivering a finished MP4. ## Core Features & Use Cases - Three content modes: guided meditations with deliberate silence pacing, long-form sleep essays with continuous slow narration, and awake casual-essay documentaries with many licence-verified images and original diagrams. - Fully offline pipeline: Kokoro ONNX text-to-speech plus ffmpeg rendering, with no API keys, no GPU, and resumable segment generation. - Quality gates built in: an enforced de-AI/fact-check convergence loop blocks audio generation until essay prose passes review, and delivery includes YouTube description, chapters, and tags. - Use Case: Ask for a 20-minute narrated video essay on an obscure historical topic; the Skill researches and writes the essay, verifies it, narrates it at the right pace, sources licensed images, renders the slideshow, and delivers the MP4 with publishing metadata. ## Quick Start Create a 5-minute guided breathing meditation video with a calm female voice over a misty lake backdrop.

Frequently Asked Questions about meditation-video

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a guided meditation video offline?

Write a JSON script of text segments with pause values, generate narration WAVs with Kokoro TTS, stitch them with exact silence using build_audio.py, then render over a still image with ffmpeg. The whole pipeline runs locally with no API key or GPU.

What TTS tool works without a GPU or API key?

Kokoro ONNX runs the Kokoro v1.0 weights through onnxruntime on CPU only, avoiding a large PyTorch install. It generates speech at several times real-time and supports multiple voices such as the default af_heart.

Can I make a narrated video essay with multiple images?

Yes, the casual essay mode sources around 30 licence-verified images, builds original SVG diagrams, and renders a slideshow with slow pans and dissolves via render_slideshow.py. It also generates YouTube description, chapters, and tags.

Why does audio generation refuse to run for my essay script?

Essay-derived scripts are stamped passes_required, so generate_segments.py demands a passes.json report showing one clean cycle of all nine de-AI and fact-check passes. Run the convergence loop until a full cycle returns zero findings, then write the report.

How do I keep a long narrated video under the 30 MiB delivery limit?

Re-encode with a two-pass ffmpeg compression using a video bitrate around 125k and 40k mono AAC audio, which took a 20-minute master from 133 MB to about 25 MiB. For sleep essays, rendering at 96k audio bitrate often avoids re-encoding entirely.