skills.rest
rezrov
rezrovCOMMUNITY
Explore all skills by this author →
GitHub

kitty-cli-display-image

Display images in a fixed Kitty terminal overlay using the Kitty graphics protocol.

1|Updated May 3, 2026
Search Tags:#bash#terminal graphics#image display#icat#overlay window#kitty terminal#image preview
One-click install
npx skills add https://github.com/rezrov/claude-marketplace --skill kitty-cli-display-image-rezrov
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: kitty-cli-display-image
Source: https://github.com/rezrov/claude-marketplace/tree/main/plugins/kitty-cli-display-image/skills/kitty-cli-display-image
Command: npx skills add https://github.com/rezrov/claude-marketplace --skill kitty-cli-display-image-rezrov

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Terminal-based workflows cannot show images inline, forcing users to leave the terminal or open external viewers to inspect generated charts, screenshots, or edited images. This Skill renders images directly inside the Kitty terminal as a fixed, centered overlay window. ## Core Features & Use Cases - Overlay Image Display: Shows PNG, JPEG, GIF (including animated), BMP, TIFF, and WebP images in a fixed overlay window scaled to fit with a 2-cell border, centered on both axes. - Sequence and Slideshow Support: A --no-prompt mode lets an agent drive timed image sequences, with each new image replacing the previous one without flicker. - Programmatic Dismissal: The --dismiss flag closes the overlay from outside, tracked by the window id kitty reported at launch. - Use Case: After generating a matplotlib chart or editing a screenshot, display it immediately in the terminal so the user can review the result without switching applications. ## Quick Start Show the file chart.png in the terminal so I can see the generated graph.

Frequently Asked Questions about kitty-cli-display-image

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I display an image in the Kitty terminal?▼

Run the display.sh script with the image path, which opens the image in a fixed Kitty overlay window via kitten icat. The image is scaled to fit with a 2-cell border and centered, and pressing any key dismisses it.

What image formats does kitten icat support?▼

kitten icat renders PNG, JPEG, GIF (including animated), BMP, TIFF, and WebP without conversion. Vector and document formats like SVG and PDF are not decoded by kitty's builtin decoder, so convert them to PNG first.

Why does the script say KITTY_LISTEN_ON is not set?▼

This error means Kitty remote control is not enabled or Kitty was not restarted after enabling it. Add 'allow_remote_control socket-only' and 'listen_on unix:kitty-{kitty_pid}' to kitty.conf, then fully restart Kitty so the listening socket is created.

Can I show a slideshow of images in the terminal?▼

Yes, pass --no-prompt before each image path to hide the keypress hint while driving a timed sequence. Each new image replaces the previous overlay in one step, and a single --dismiss call at the end closes the final overlay.

Why is my image displayed top-aligned instead of centered?▼

Vertical centering requires the image's pixel dimensions, read via sips, ImageMagick's identify, or file. When none can determine the size, the image is still displayed but top-aligned, and a warning is written to stderr.

Related Skills

Explore More Software Engineering Skills→
Mo7amed-MahmoudMo7amed-Mahmoud

remove-image-background

Remove backgrounds from PNG, JPG, JPEG, and WebP images to produce transparent PNG files.

Community
Basic
xpert-aixpert-ai
8

canvas-agent-skill

Manage tldraw Canvas document lifecycles with versioning and recovery.

Official
Advanced
rmjamesrmjames
1

image-processor

Resize and crop raster and SVG images with ImageMagick and SVGO.

Community
Advanced
BoChao1ZhangBoChao1Zhang

show-image

Display images in Kitty terminals via scripts/show_image.py.

Community
Intermediate