Command line

asciify-engine is also a command. Pictures, GIFs, video and 3D models become ASCII in your terminal, or SVG, HTML, text and JSON files. It needs only Node 18 or later: images are decoded by the engine itself, with no native modules, so npx runs it anywhere.

terminal
npx asciify-engine photo.jpg                     # fits the terminal, in colour where it can
npx asciify-engine photo.jpg --half              # two true-colour pixels a character
npx asciify-engine logo.png --light -o logo.svg  # a vector file for a README or Figma
npx asciify-engine loop.gif -o loop.svg          # an animated SVG that plays on GitHub
npx asciify-engine clip.mp4 -w 120               # video, through ffmpeg
npx asciify-engine helmet.glb                    # turn a 3D model with the mouse
npx asciify-engine torus                         # the classic spinning donut

Modes

shape (the default) picks the character whose strokes follow the picture, so edges become / \ | _.tone is the classic brightness ramp. braille, half, quad and sextant put several pixels in each character; with --color each cell takes two colours, as terminal image viewers do.

Files

-o writes a file and its extension picks the format. An animated SVG plays by CSS alone, with no script, and holds its first frame for readers who turn motion off. --dark-ink follows the reader's dark theme, so one file suits both README themes. JSON carries every frame's characters and colours for your own renderer.

In the terminal

Animations, video and models play full screen and give the terminal back when they finish. Space pauses and q quits. A model turns with the mouse, the arrow keys and the wheel, and draws nothing while it is still. In a pipe, the command writes plain text with no escape codes.