skills.rest
surfingalien
surfingalienCOMMUNITY
Explore all skills by this author →
GitHub

ascii-pixel-art

Convert images into animated ASCII art HTML with subject detection and interactive effects.

1|Updated May 6, 2026
Search Tags:#creative coding#generative art#ascii art#pixel art#rembg#image conversion#html animation
One-click install
npx skills add https://github.com/surfingalien/FinSurfing --skill ascii-pixel-art-surfingalien
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ascii-pixel-art
Source: https://github.com/surfingalien/FinSurfing/tree/main/.claude/skills/ascii-pixel-art
Command: npx skills add https://github.com/surfingalien/FinSurfing --skill ascii-pixel-art-surfingalien

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pillow, rembg, numpy, and includes scripts (resource) components.

What problem does it solve? Transforming photos into retro ASCII art typically requires manual editing or produces static, low-quality output. This Skill automates the conversion of images into animated, interactive ASCII art with subject detection, atmospheric backgrounds, and cinematic effects in a single self-contained HTML file. ## Core Features & Use Cases - Subject Detection: Uses rembg computer vision to isolate foreground subjects from backgrounds, applying ASCII characters only to detected subjects. - Animated Effects: Generates HTML with sine wave pulses, diagonal shine sweeps, random flickers, hover ripples, and dynamic glow effects at 60fps. - Layered Composition: Combines blurred pixelated backgrounds, pixel grid overlays, and ASCII character canvases into one portable file. - Use Case: Convert a portrait photo into a cyberpunk-style animated artwork for a personal website, social media post, or creative coding demo by running one Python command. ## Quick Start Ask the AI to convert your image into animated ASCII art by running the ascii_pixel_effect.py script on your photo file.

Frequently Asked Questions about ascii-pixel-art

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

FAQPage Schema
How do I convert an image to ASCII art in Python?▼

Run the ascii_pixel_effect.py script with your image path as the argument, for example: python3 ascii_pixel_effect.py portrait.jpg. It generates a self-contained HTML file with animated ASCII art that opens directly in a browser.

What Python packages are needed for ASCII art generation with subject detection?▼

The script requires pillow for image processing, rembg for background removal and subject detection, and numpy for array operations. Install them with: pip install pillow rembg numpy.

What types of images work best for ASCII art conversion?▼

Portraits, people, and distinct objects with clear foreground/background separation produce the best results. Landscapes, abstract patterns, and busy backgrounds are not recommended because subject detection relies on a clear mask from rembg.

Why is my subject not detected in the ASCII art output?▼

Subject detection fails when the rembg mask mean falls below the 0.25 threshold, usually due to poor foreground/background separation. Try images with stronger contrast between the subject and background.

Does the generated ASCII art require external dependencies to view?▼

No, the output is a self-contained HTML file with the background image base64-encoded and all CSS and JavaScript inlined. It opens directly in any browser with no external dependencies.

Related Skills

Explore More Design & Creative Skills→
iterationlayeriterationlayer
2

image-transformation-api

Apply ordered image operations and return base64-encoded JSON.

Official
Advanced
Lev-itLev-it

website-to-video

Capture website visuals and generate a HyperFrames video.

Official
Advanced
artgaurav16420-ossartgaurav16420-oss

image-enhancer

Upscale resolution, sharpen edges, and reduce artifacts in images.

Community
Intermediate
travelinman1013travelinman1013

ascii-art

Convert text or images into decorative ASCII art using local tools.

Community
Intermediate