graphsay

Generate animated GitHub-style contribution graph messages as SVG, GIF, WebP, or MP4.

Installation

Prerequisites

• Node.js v18 or later
• ffmpeg (only needed for GIF, WebP, and MP4 output)

Run with npx (no install needed)

npx graphsay -m "HELLO WORLD" -f svg

Install globally

npm install -g graphsay

Install from source

git clone https://github.com/leereilly/graphsay.git
cd graphsay
npm install
npm run build

Usage

npx graphsay --message "HELLO WORLD" --format svg

Options

| Flag | Description | Default | |------|-------------|---------| | -m, --message <TEXT> | Message to display (required, max 500 chars) | — | | -t, --theme <THEME> | light, dark, or both | both | | -f, --format <FORMAT> | svg, gif, webp, mp4 | mp4 | | -o, --output <PATH> | Output file path | auto-generated | | --color <HEX> | Text color hex code | #40c463 | | --mode <MODE> | scroll or static | scroll | | --speed <SECONDS> | Step interval in seconds | 0.15 | | --no-transparent | Add a background color instead of transparent | transparent | | --no-loop | Disable looping (SVG plays once and freezes; GIF does not loop) | loops |

Examples

# SVG with light theme (scroll)
npx graphsay -m "HELLO WORLD" -f svg -t light

# SVG with both light/dark mode support
npx graphsay -m "HELLO WORLD" -f svg -t both

# Static centered text (dark theme)
npx graphsay -m "HELLO WORLD" -f svg -t dark --mode static

# Custom color
npx graphsay -m "RUST" -f svg --color "#ff6600"

# GIF output (requires ffmpeg)
npx graphsay -m "HELLO" -f gif -t light

# With background color (non-transparent)
npx graphsay -m "HELLO WORLD" -f svg -t dark --no-transparent

# MP4 video (requires ffmpeg)
npx graphsay -m "HELLO" -f mp4

➡️ Output

Requirements

• SVG output: No additional dependencies
• GIF/WebP/MP4 output: Requires ffmpeg to be installed and available on PATH

Testing

npm test

License

MIT