ascii-video

Convert video and audio inputs into colored ASCII character video with ffmpeg encoding.

Updated May 16, 2026
One-click install
npx skills add https://github.com/jaredcroxton/hermes-mirror --skill ascii-video-jaredcroxton
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ascii-video
Source: https://github.com/jaredcroxton/hermes-mirror/tree/main/agents/skills/creative/ascii-video
Command: npx skills add https://github.com/jaredcroxton/hermes-mirror --skill ascii-video-jaredcroxton

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It turns your video, audio, images, text, or math into a fully rendered, color-accurate ASCII character video so you can produce cinematic ASCII output without building the rendering pipeline from scratch.

Core Features & Use Cases

  • End-to-end ASCII video pipeline: Builds a single-file Python renderer that decodes inputs, analyzes features, renders multi-grid colored ASCII frames, applies tonemapping, shaders, and encodes to MP4/GIF/image sequences.
  • Multi-modal modes: Supports video-to-ASCII, audio-reactive visualizers, generative animation, hybrid video+audio, timed lyrics/text overlays, and TTS narration output.
  • High-detail visuals: Uses per-character font bitmap rasterization, adaptive percentile tonemapping (instead of linear brightness scaling), composable shader chains (CRT/glitch/bloom/vignette), and temporal feedback for recursive trails.

Quick Start

Use the ascii-video skill to render the attached video into a 1080p, 24fps colored ASCII MP4 with audio-reactive effects if audio is present.

Frequently Asked Questions about ascii-video

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

FAQPage Schema
How do I convert video to colored ASCII art animation?

Colored ASCII video conversion requires a rendering pipeline that decodes input frames, rasterizes font bitmaps, applies adaptive percentile tonemapping, and encodes the output to MP4. This approach uses perceptually correct brightness handling for color-accurate cinematic results.

Can I make audio-reactive ASCII visualizers from music files?

Yes, audio-reactive ASCII visualizers are supported by analyzing audio features and mapping them to multi-grid colored ASCII frames. The pipeline applies composable shader chains like CRT, glitch, and bloom, alongside temporal feedback for recursive visual trails.

Does Python 3.10 work for generating ASCII video from media inputs?

Python 3.10+ is required to run the single-file ASCII video renderer. It executes the full pipeline from input analysis and multi-grid frame rendering to shader post-processing and ffmpeg encoding, outputting MP4, GIF, or image sequences.

What is the best way to apply CRT or glitch shaders to ASCII video frames?

Applying CRT or glitch shaders to ASCII video frames requires a composable shader chain within the rendering pipeline. This post-processes the multi-layer ASCII composition with effects like bloom and vignette before ffmpeg encoding to MP4 or GIF.

How do I add timed lyrics or TTS narration to an ASCII animation?

Adding timed lyrics or TTS narration to ASCII animation involves using the pipeline's timed text overlay and TTS narration workflows. It synchronizes multi-grid colored ASCII frame generation with audio inputs during the ffmpeg encoding phase.

Why does my ASCII video conversion have incorrect brightness scaling?

Incorrect brightness in ASCII video conversion typically stems from linear scaling rather than adaptive percentile tonemapping. Applying perceptually correct brightness handling ensures the multi-grid colored ASCII frames maintain color-accurate and detailed visual output.