How amonhoorilal/ascii-magic-art works
ASCII Magic Art is a library of animated ASCII pieces, with a CLI for browsing and playing them and a browser runtime for embedding them in web pages. A piece produces timed text and optional color frames; rendering can restyle those frames or draw them to a canvas. The README also documents image-based scenes, exports, and prompt generation. Edges are limited to README statements and source-index references; the full CLI and runtime implementations were not inspected.
Main entry points: player.js Frame player · cli.js CLI · kit.js Grid toolkit · glyphs.js Glyph restyling
Components 14
Art catalog
- Piece library
pieces - Landmark scenes
pieces/east-river-bridge-sunrise.js - Interface pieces
pieces/sql-query-runner.js - Image scenes
pieces/ocean-sunset.js
Piece toolkit
- Grid toolkit
lib/kit.js - Scene toolkit
lib/scene.js - Image motion
lib/image.js
Rendering runtime
- Frame player
runtime/player.js - Glyph restyling
runtime/glyphs.js - Canvas renderer
runtime/canvas.js
User entrypoints
- CLI
bin/cli.js - Web element
runtime/ascii.js
Other components
- Terminal user
- Web developer
Connections 14
- Terminal user → CLI: runs commands
- Web developer → Web element: embeds element
- CLI → Piece library: loads pieces
bin/cli.js - CLI → Glyph restyling: restyles frames
bin/cli.js - CLI → Frame player: applies parameters
bin/cli.js - Web element → Frame player: uses player
runtime/ascii.js - Landmark scenes → Grid toolkit: draws with
pieces/east-river-bridge-sunrise.js - Interface pieces → Grid toolkit: draws with
pieces/sql-query-runner.js - Image scenes → Image motion: creates motion
pieces/ocean-sunset.js - Scene toolkit → Grid toolkit: uses helpers
lib/scene.js - Frame player → Glyph restyling: restyles frames
runtime/player.js - Frame player → Canvas renderer: renders frames
runtime/player.js - Canvas renderer → Glyph restyling: uses glyph metrics
runtime/canvas.js - Frame player → Piece library: plays pieces