git404hub

what is decor-cli fr?

mrgoonie/decor-cli — explained in plain English

Analysis updated 2026-05-18

7TypeScriptAudience · developer

tl;dr

A CLI and MCP tool that decorates screenshots and videos with backgrounds, shadows, text, arrows, and templates.

vibe map

mindmap
  root((decor-cli))
    What it does
      Image video decoration
      Backgrounds and shadows
      Text and arrows
    Tech stack
      TypeScript
      Node.js
      ffmpeg
    Use cases
      Release note screenshots
      Tutorial annotations
      Template styling
    Audience
      Developers
      AI agents

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Add a polished background, padding, and rounded corners to a screenshot for release notes or docs.

VIBE 2

Annotate a screenshot with arrows, numbered steps, and text callouts for a tutorial.

VIBE 3

Apply a reusable template so a series of screenshots share the same visual style.

VIBE 4

Let an AI agent render or preview decorated images directly through the MCP server.

what's the stack?

TypeScriptNode.jsffmpegMCP

how it stacks up fr

mrgoonie/decor-cliadguardteam/ruleseditorartickc/opencode-telegram-bot
Stars777
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-07-01
MaintenanceActive
Setup difficultyeasymoderate
Complexity2/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

in plain english

decor-cli is a command line tool that adds visual decoration to screenshots and videos, things like backgrounds, rounded borders, shadows, arrows, text labels, and numbered callouts, without changing the original image or video's proportions. It is aimed at people who need to turn a plain screenshot into something that looks polished for release notes, documentation, or a demo, without opening a design program. The tool can add solid color or gradient backgrounds, place the image inside a padded container with rounded corners and a drop shadow, crop it, and align it in nine possible positions. It accepts input from a local file, a web link, or raw image data, and works on both images and videos, with video handling powered by the system tools ffmpeg and ffprobe. On top of the base image it can draw text with custom fonts, sizes, colors, and outlines, along with arrows, rectangles, circles, numbered counters, and a spotlight effect that brightens one area while dimming the rest. Reusable named templates let someone apply a consistent style across many images without repeating every setting. Every option can also be set through a single JSON configuration file instead of long command line flags, which is useful for repeatable jobs or for reviewing exactly what will happen before running it. Beyond the command line, decor-cli can run as an MCP server, meaning it exposes rendering, previewing, validating, and template-listing tools that an AI agent can call directly, alongside a companion command line and installer for a starter set of hosted background images. Installation is a single npm global install command, plus installing ffmpeg and ffprobe separately if video support is needed. Downloaded background packs are checked against file size and a SHA-256 hash before replacing anything already on disk, and by default the tool blocks fetching images from private, local, or internal network addresses unless that is explicitly allowed. The README does not state a license for the project.

prompts (copy fr)

prompt 1
Walk me through installing decor-cli and rendering my first decorated screenshot.
prompt 2
Explain how to set up a JSON config file to apply padding, radius, and text annotations.
prompt 3
Show me how to use decor-cli's MCP server so an agent can render images directly.
prompt 4
Help me create a reusable template for consistent screenshot styling across a project.

Frequently asked questions

what is decor-cli fr?

A CLI and MCP tool that decorates screenshots and videos with backgrounds, shadows, text, arrows, and templates.

What language is decor-cli written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, ffmpeg.

Who is decor-cli for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.