ascii-video

Convert video, audio, and text into colored ASCII character video rendered to MP4 or GIF.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires numpy, pillow, scipy, opencv-python, and includes references (resource) components.

What problem does it solve? Creating animated ASCII art video requires building a full rendering pipeline from scratch: font rasterization, character grids, audio analysis, effects, shaders, and ffmpeg encoding. This Skill gives an agent the complete architecture and reference code to generate single-file Python renderers that turn any input into colored ASCII video. ## Core Features & Use Cases - Six input modes: video-to-ASCII conversion, audio-reactive visualizers with FFT beat detection, generative procedural animation, hybrid video+audio, timed lyrics/text overlays, and TTS-narrated quote videos via ElevenLabs. - Full effect vocabulary: 21 value field generators, 24 character palettes, 38 composable shaders, 20 blend modes, particle systems, feedback buffers, and masking for layered multi-grid composition. - Production pipeline: adaptive tonemapping, hardware-aware quality profiles, parallel ffmpeg encoding, and per-scene configuration for 1080p 24fps output without a GPU. - Use Case: Give the agent an audio track and ask for a music visualizer; it writes a Python script with beat-reactive particles, section-based scenes, and shader moods, then renders the final MP4. ## Quick Start Ask the agent to create an audio-reactive ASCII music visualizer from your audio file and render it as a 1080p MP4.

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 to ASCII art video in Python?

Sample frames from the source video, map per-cell luminance to characters from a density palette, color cells from the original pixels, and pipe rendered frames to ffmpeg. This Skill provides the full pipeline including grids, palettes, and encoding.

How do I make an audio-reactive ASCII music visualizer?

Extract per-frame audio features with FFT: 6 frequency bands, RMS energy, spectral centroid, and beat detection with exponential decay. Drive value fields, particles, and shaders from those features, then encode frames to MP4 with the audio muxed.

Does ASCII video rendering require a GPU?

No GPU is required. Rendering uses NumPy-vectorized effects and Pillow font rasterization on CPU, with parallel workers for encoding. Hardware detection adjusts resolution and worker count automatically.

Why is my ASCII video output too dark?

ASCII characters are small bright dots on black, so linear brightness multipliers clip highlights and leave frames dark. Use percentile-based adaptive tonemapping with gamma around 0.75 instead of multiplying the canvas.

Why does ffmpeg hang during long video encoding?

Setting stderr=subprocess.PIPE on a long-running ffmpeg process deadlocks once the buffer fills at about 64KB. Redirect stderr to a log file instead and keep stdin as the raw frame pipe.

What are the limitations of ASCII video rendering in pure Python?

The per-cell character compositing loop runs at roughly 100-150ms per frame and is the bottleneck without Cython or C. A 5-minute 1080p video takes about 17 minutes on 8 workers; 4K roughly quadruples render time.