◎
Shellfie Terminal Screenshot Generator
GitHub

YAML → Image → Imagination

Terminal visuals that elevate
your documentation

Shellfie is a CLI that generates PNGs and animated GIFs from YAML. Build documentation, tutorials, and presentations without taking screenshots.

Quick Start View Config
Ruby 3.0+ ImageMagick 7.0+ CLI: shellfie / shf

Features

Make visuals and storytelling effortless

Switch themes, animate typing, and support ANSI colors to level up your docs.

Multi Theme

Switch between macOS, Ubuntu, and Windows terminal styles.

Animated GIF

Create typing animations that feel like a guided walkthrough.

Full ANSI

Support 256-color palettes, TrueColor, and text styles.

HiDPI Output

Render crisp assets with 2x or 3x scaling for HiDPI.

Install

Install in two steps

ImageMagick

brew install imagemagick
# Ubuntu/Debian
sudo apt install imagemagick

Shellfie

gem install shellfie
# or
bundle add shellfie

Usage

Quick Start

Create a YAML file, then generate the output.

terminal.yml

theme: macos
title: "Terminal — zsh"

window:
  width: 620
  padding: 20

lines:
  - prompt: "$ "
    command: "echo 'Hello, Vaporwave!'"
  - output: "Hello, Vaporwave!"

Generate

shellfie generate terminal.yml -o output.png
shellfie generate terminal.yml -o demo.gif --animate

Config

Animation controls

Tune typing speed, delays, and looping. 

animation:
  typing_speed: 50
  command_delay: 500
  cursor_blink: true
  loop: true

frames:
  - prompt: "$ "
    type: "ls -la"
    delay: 400
  - output: "docs  lib  README.md"
    delay: 800

Themes

Shape the vibe with themes

macos
ubuntu
windows
headless
shellfie themes
shellfie generate config.yml -o neon.png -t ubuntu
shellfie generate config.yml -o ghost.png --no-header