polli-video

Records terminal demo videos of the polli CLI using VHS with generated voiceover and music.

5.0k|1.0k|Updated Apr 15, 2021
One-click install
npx skills add https://github.com/pollinations/pollinations --skill polli-video
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polli-video
Source: https://github.com/pollinations/pollinations/tree/main/.claude/skills/polli-video
Command: npx skills add https://github.com/pollinations/pollinations --skill polli-video

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Recording polished terminal demo videos with synchronized narration and background music is tedious: VHS captures silent video only, audio capture tools drop samples, and shell quirks corrupt typed commands. This Skill provides a tested pipeline that records the polli CLI, generates voiceover and music via the Pollinations API, and muxes everything into a finished MP4.

Core Features & Use Cases

  • VHS tape conventions: Canonical bash Hide block, announce() helper for scene titles with backgrounded TTS, and a gotcha table covering zsh races, job-control leaks, color stripping, and Unicode issues.
  • Two audio pipelines: BlackHole live capture via sox + CoreAudio (recommended) or post-hoc ffmpeg overlay with adelay timing, ducking levels, and fade-out.
  • AI-generated content: ElevenLabs voiceover with emotion cues, elevenmusic instrumental tracks matched to video duration, and guidance for generating LinkedIn announcement posts and streaming ASCII outros.
  • Use Case: Record a launch demo of the polli CLI for LinkedIn — five scenes with narrated titles, streaming text generation, and an ASCII wordmark outro — producing a ready-to-post demo.mp4.

Quick Start

Copy the example folder to a temp directory, set your system output to BlackHole 2ch, and run render.sh to produce demo.mp4.

Frequently Asked Questions about polli-video

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

FAQPage Schema
How do I record a terminal demo video with voiceover?

Use VHS to record the silent terminal video, generate narration with a TTS CLI, and mux them with ffmpeg. This Skill automates it via render.sh, which captures system audio through BlackHole while VHS runs and muxes the result into a final MP4.

How to capture system audio on macOS for screen recordings?

Set the default system output to BlackHole 2ch and record it with sox using the CoreAudio driver, addressing the device by name. This is more stable than ffmpeg avfoundation, which drops samples on long recordings and relies on flaky device indexes.

Why do VHS typed commands merge onto one line?

Long Type lines under zsh trigger a race between zsh's line editor and VHS's keystroke injection, gluing two commands together and losing the Enter between them. Set Shell to bash in the tape, since bash's simpler line editor avoids the race.

Why does my ffmpeg muxed video have no sound or get truncated?

Missing audio means the audio stream was not mapped; use -map 0:v -map "[a]" explicitly. Truncation happens when -shortest is passed, cutting the video to the shortest audio track, so omit it and control length with -t instead.

Can I add background music and narration to an existing silent video?

Yes, use the post-hoc ffmpeg overlay pipeline: delay narration with adelay (in milliseconds per channel), lower music volume to 0.12–0.20 under speech, mix with amix, and map both video and mixed audio into the output.