CandyFlip — SugarCraft

🎞 CandyFlip

ASCII GIF viewer

port of gifterm gif ascii-art ext-gd truecolor

Decodes a .gif on disk via ext-gd, downsamples each frame to a configurable cell grid, and renders the animation as ANSI-coloured Unicode block-glyphs. Two presets: solid 24-bit blocks or a luminance-ramp ASCII rendering.

Install

composer require candycore/candy-flip

Quickstart

candy-flip my-animation.gif         # solid blocks (default)
candy-flip my-animation.gif density # luminance ramp

// Programmatic:
use CandyCore\Core\Program;
use CandyCore\Core\ProgramOptions;
use CandyCore\Flip\Decoder;
use CandyCore\Flip\Player;

$frames = Decoder::decode('cat.gif', cellsW: 80, cellsH: 30);
(new Program(new Player($frames),
             new ProgramOptions(useAltScreen: true)))->run();

What's in the box

ext-gd decodeWalks the GIF byte stream for image-descriptor offsets, hands each frame to GD, downsamples to cell space.

Two presetssolid — full-cell █ in 24-bit truecolor. density — luminance ramp ` .:-=+*#%@`.

Pause + stepSpace pauses; ← / → step through frames manually.

Preset toggled swaps solid ↔ density without losing your position.

Frame capDecoder caps at 256 frames so a runaway file can't OOM the runtime.

Cmd::tick drivenCmd::tick($interval, …) schedules frame advance — no busy-waiting in the main fiber.

Source & demos

Try the quickstart →

🎞 CandyFlip

Install

Quickstart

What's in the box

Source & demos

Demos.

Play