Add a polished background, padding, and rounded corners to a screenshot for release notes or docs.
Annotate a screenshot with arrows, numbered steps, and text callouts for a tutorial.
Apply a reusable template so a series of screenshots share the same visual style.
Let an AI agent render or preview decorated images directly through the MCP server.
| mrgoonie/decor-cli | adguardteam/ruleseditor | artickc/opencode-telegram-bot | |
|---|---|---|---|
| Stars | 7 | 7 | 7 |
| Language | TypeScript | TypeScript | TypeScript |
| Last pushed | — | 2026-07-01 | — |
| Maintenance | — | Active | — |
| Setup difficulty | — | easy | moderate |
| Complexity | — | 2/5 | 3/5 |
| Audience | developer | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
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.
A CLI and MCP tool that decorates screenshots and videos with backgrounds, shadows, text, arrows, and templates.
Mainly TypeScript. The stack also includes TypeScript, Node.js, ffmpeg.
Mainly developer.
This repo across BitVibe Labs
double-check against the repo, no cap.