kitty-gif-renderer

What problem does it solve?

Many terminal-based panel extensions cannot display animated images inline, leading to bland UI and manual workarounds; this Skill provides a simple, optional integration for rendering animated GIFs in terminal UIs using the Kitty graphics protocol and ensures panels degrade gracefully when image support is absent.

Core Features & Use Cases

• Kitty protocol rendering: Render animated GIF frames into terminal virtual placements for inline display in panels.
• Asynchronous loading and lifecycle: Load images with onReady callbacks, guard against stale references, and explicitly dispose to free terminal memory.
• Float merging for text flow: Create mergers that let text flow alongside a right- or left-floating image and flush remaining image rows after content ends.
• Graceful degradation and best practices: Check for the global Symbol-based API before use, avoid direct imports, and follow disposal patterns to prevent leaks.
• Use Case: Add an animated mascot or inline GIF to a floating panel in a Pi extension while preserving readable text flow and terminal stability.

Quick Start

Render the attached animated GIF at 24 columns by 12 rows in the panel and flow text alongside it using the kitty-gif-renderer API.