ascii-video

Convert video, audio, images, and timed text into colored ASCII animations.

4|Updated May 18, 2026
One-click install
npx skills add https://github.com/ZardLi1115/zedclaw --skill ascii-video-zardli1115
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ascii-video
Source: https://github.com/ZardLi1115/zedclaw/tree/main/skills/creative/ascii-video
Command: npx skills add https://github.com/ZardLi1115/zedclaw --skill ascii-video-zardli1115

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python>=3.10, numpy, pillow, scipy, ffmpeg, opencv(optional), elevenlabs(optional), and includes references (resource) components.

What problem does it solve?

Converts video, audio, images, and timed text into visually rich colored ASCII animations, avoiding the slow trial-and-error of building a renderer and tweaking it until it looks cinematic.

Core Features & Use Cases

  • Video-to-ASCII Production Pipeline: Decodes input, analyzes features, renders multi-grid character frames, tonemaps brightness correctly, shades with a modular shader chain, then encodes to MP4/GIF/frames.
  • Audio-Reactive Modes: Drives visuals from FFT bands, energy metrics, flux/transients, and beat detection for music visualizers.
  • Generative + Hybrid Rendering: Produces procedural ASCII animations and overlays audio-reactive effects on video.

Quick Start

Use the ascii-video skill to convert your file by asking an agent: "Create a 1080p (24fps) colored ASCII MP4 from the uploaded video, using an audio-reactive hybrid mode and exporting at production quality."

Frequently Asked Questions about ascii-video

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

FAQPage Schema
How do I convert a video into colored ASCII art?

To convert video into colored ASCII art, you need a rendering pipeline that decodes input, analyzes features, renders multi-grid character frames, applies tonemapping, and shades through a modular chain to export MP4 or GIF outputs.

Can I create audio-reactive ASCII visualizations from music?

Yes, you can create audio-reactive ASCII visualizations by driving visuals from FFT bands, energy metrics, flux, transients, and beat detection to generate dynamic music visualizer animations.

How does tonemapping work for ASCII video rendering?

Adaptive percentile tonemapping analyzes brightness during ASCII video rendering to ensure correct luminance distribution across multi-grid character frames before applying color shaders.

Do I need ffmpeg to encode ASCII animations to MP4 or GIF?

Yes, ffmpeg is required for encoding rendered ASCII character frames into final MP4, GIF, or image sequence outputs during the video conversion pipeline.

What's the best way to generate procedural ASCII animations with text?

To generate procedural ASCII animations with text, use timed text or TTS narrated segments combined with hybrid rendering to overlay audio-reactive effects on video.

Does this ASCII video pipeline support image inputs?

Yes, the ASCII video pipeline supports converting images alongside video, audio, and timed text by analyzing inputs and rendering multi-grid scenes through a shader and feedback pipeline.