claudeers.
// Claude Skills

living-ascii

Bring a still image to life as a seamless ASCII loop — hundreds of thousands of strands swaying like a school of fish, with ASCII glyphs that turn with them.…

// Claude Skills[ api ][ desktop ][ web ][ mobile ][ claude ]#claude#animation#ascii#ascii-art#claude-code#claude-skill#creative-coding#generative-art#skills◷ MIT$open-sourceupdated 4 days ago

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up living-ascii (claude-skill project) into my current project.
Found on https://claudeers.com/living-ascii
Repo: https://github.com/yusen-dev/living-ascii
Homepage/docs: —
Detected install method: claude-skill → # copy this skill into .claude/skills/living-ascii/
Category: skills. Platforms: api, desktop, web, mobile.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or install directly (claude-skill)
# copy the skill dir into your project:
# .claude/skills/living-ascii/   (or ~/.claude/skills/living-ascii/ for all projects)
// or clone
git clone https://github.com/yusen-dev/living-ascii

// compatibility

Platformsapi, desktop, web, mobile
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageJavaScript

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

English · 简体中文

living-ascii: the name filled with ASCII grass swaying in the wind

Bring a still image to life as a seamless ASCII loop

Every blade sways in the wind, and every character turns with the blade beneath it.
Custom shaders on three.js, rendered live in your browser, exported as an MP4 that loops without a seam.


01 What it does: a still image in, a seamless loop out

The same patch of grass three ways: the still photo, 160k strands, and stroke glyphs. The loupe shows each character is a slanted stroke following the grass

  • Works on your image. Drop one in; the wind follows the image's own texture by default.
  • Characters turn. When a strand turns, the glyph on top of it turns too. It is not a static filter.
  • Colour stays true. No blown highlights, no neon, no crushed shadows.
  • Seamless. The last frame flows straight back into the first, so it can loop forever.

02 How it works: strands sway like a school of fish; glyphs follow

  1. Read the image. Blur its brightness at two scales to get the big hills and the small tufts, and use a structure tensor to find which way the texture runs at every point.
  2. Rebuild it as strands. About 160k strands for a 1080×1772 frame, each a 7-segment ribbon carrying the colour of the patch it covered at rest.
  3. Move them like a school of fish. Turning waves sweep across, sub-groups drift and turn at their own moments, the whole field leans slowly, and each strand adds a little motion of its own. Tips lag roots, so every turn whips up the strand.
  4. Light. A sun swings around the image's own light direction, light pools drift through cloud gaps, and strands flash as they turn across the sun.
  5. ASCII. A second pass records each strand's heading. Every 5×7 cell picks one of 32 stroke glyphs (8 angles × 4 weights) to match. Each weight lights the same number of pixels at every angle, so horizontal strands don't read darker than diagonal ones. Colour is solved per cell so it averages back to the image.
  6. Loop. Every moving term repeats a whole number of times per loop.

03 Get started: run it yourself, or hand it to Claude Code

Just want the wallpaper?

The grass loop as a 16:9 desktop wallpaper and a tall phone wallpaper

DownloadSize
Desktop3840×2160 (4K, 16:9)
Phone1290×2796

Each is a 12-second loop at 30 fps. The last frame flows straight back into the first, so it repeats without a jump. To set it:

  • Windows: import the video into Wallpaper Engine.
  • Mac: macOS can't use a video as a wallpaper by itself. Install a live-wallpaper app from the App Store and add the video.
  • Android: most phones can set a video as a live wallpaper straight from the gallery.
  • iPhone: iOS has no looping video wallpaper. You can turn a few seconds into a Live Photo for the lock screen.

For your own image or your screen's exact size, see Make a wallpaper below.

Option 1 · Run it yourself

Requires Node.js 18+.

git clone https://github.com/yusen-dev/living-ascii.git
cd living-ascii
npm install
npm start

Open http://localhost:5177 to see the sample. To use your own image, put it in input/ and open http://localhost:5177/?img=input/your-image.jpg.

Export a video. Add &export=ascii,flow to the URL and keep the tab in front until it says done. You get out/your-image-ascii.mp4 and out/your-image-flow.mp4 (the strands without the ASCII layer). Then check the loop has no visible jump:

npm run check -- out/your-image-ascii.mp4

Make a wallpaper. Set width and height to your screen's resolution, e.g. &width=2560&height=1600. The image is cropped to that shape, and focus=0.5,0.3 picks which part to keep (0–1 across, 0–1 down). Render at the screen's full resolution: the characters are 5×7 pixels, so they blur if the video is scaled up.

Option 2 · Hand it to Claude Code

Install the repo as a skill:

git clone https://github.com/yusen-dev/living-ascii.git ~/.claude/skills/living-ascii

Then give Claude Code your image and say:

Use living-ascii to bring this image to life as an ASCII loop

SKILL.md walks it through the whole job: judging whether the image suits the effect, tuning wind and light, exporting, then checking the loop, the motion and the colour.

Best images

Anything made of many fine strokes running in a direction: grass, wheat, fur, hair, reeds, brush-stroke paintings, wind-swept water. Hard-edged subjects (buildings, faces, text) work less well, because the strands smear their outlines.

All options

All set in the URL, e.g. ?img=input/x.jpg&wind=20&amp=1.3.

ParameterDefaultWhat it does
imgthe sampleImage to bring to life (path inside the repo)
modeasciiascii or flow (strands only). Press M to switch
width1080Output width in px
heightfollows the imageOutput height in px. With width also set, the image is cropped to that shape
focus0.5,0.5Which part of the image to keep when cropping (0–1 across, 0–1 down)
windautoWind direction in degrees (0 = right, 90 = up). auto follows the texture's own direction
light130Where the light in your image comes from, in degrees (130 = upper left)
amp1Sway amount
density1Strand count multiplier
loop12Loop length in seconds
fps30Export frame rate
t—Freeze at a point in the loop (0–1), for stills
export—ascii, flow or both: render one loop and encode MP4s

Space pauses.

Files
src/maps.js      image → height and strand-direction maps
src/field.js     strands, motion and light (vertex + fragment shaders)
src/ascii.js     the ASCII layer: stroke atlas and per-cell colour solve
src/post.js      render targets, flow grade, mode switch
src/main.js      URL options, live preview, frame export
server.mjs       local server + ffmpeg encoding
scripts/check-loop.mjs   seamless-loop check
SKILL.md         instructions for Claude Code / AI agents

MIT licensed

// faq

What is living-ascii?

Bring a still image to life as a seamless ASCII loop — hundreds of thousands of strands swaying like a school of fish, with ASCII glyphs that turn with them. three.js + custom shaders.. It is open-source on GitHub.

Is living-ascii free to use?

living-ascii is open-source under the MIT license, so it is free to use.

What category does living-ascii belong to?

living-ascii is listed under skills in the Claudeers registry of Claude-compatible tools.

8 views
★ 46 stars
unclaimed
updated 4 days ago

// embed badge

living-ascii on Claudeers
[![Claudeers](https://claudeers.com/api/badge/living-ascii.svg)](https://claudeers.com/living-ascii)

// retro hit counter

living-ascii hit counter
[![Hits](https://claudeers.com/api/counter/living-ascii.svg)](https://claudeers.com/living-ascii)

// reviews

// guestbook

0/500

// related in Claude Skills

🔓

An agentic skills framework & software development methodology that works.

// skillsobra/⟨Shell⟩★ 314,126◷ MIT[ claude ]
🔓

Public repository for Agent Skills

// skillsanthropics/⟨Python⟩★ 188,182[ claude ]
🔓

AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…

// skillsGraphify-Labs/⟨Python⟩★ 149,064◷ MIT[ claude ]
🔓

💫 Toolkit to help you get started with Spec-Driven Development

// skillsgithub/⟨Python⟩★ 148,200◷ MIT[ claude ]
→ see how living-ascii connects across the ecosystem