codesnap

Beautiful code screenshots with syntax highlighting

codesnap is a CLI tool that generates stunning code screenshots with syntax highlighting, supporting multiple themes, fonts, and customization options.

Features

• 🎨 10+ Built-in themes — Dracula, Monokai, GitHub Dark/Light, Nord, One Dark, Night Owl, VS Code, Solarized Dark, Material Light
• 🔤 Custom fonts — Use any monospace font (Fira Code, JetBrains Mono, Cascadia Code, etc.)
• 📐 Fully customizable — Padding, font size, line height, line numbers
• 🖼️ macOS window chrome — Beautiful traffic-light buttons and title bar
• 📦 Zero dependencies at runtime — Pure Node.js + Canvas

Install

npm install -g @mazhu/codesnap

Or use directly with npx:

npx @mazhu/codesnap script.js

Usage

Basic

codesnap script.js

Choose theme

codesnap script.js --theme monokai
codesnap app.ts --theme github-dark

Specify language

codesnap app.js --lang typescript

Customize appearance

codesnap script.js \
  --font "JetBrains Mono" \
  --font-size 16 \
  --padding 48 \
  --line-numbers

List all themes

codesnap --list-themes

Options

| Option | Short | Description | Default | |---------------------|-------|--------------------------------------|-------------| | --output | -o | Output file path | code-screenshot.png | | --theme | -t | Color theme name | dracula | | --lang | -l | Language (auto-detected from ext) | — | | --padding | -p | Padding around code (px) | 32 | | --font | -f | Font family | Fira Code | | --font-size | -s | Font size (px) | 14 | | --line-height | -h | Line height ratio | 1.5 | | --line-numbers | -n | Show line numbers | false | | --list-themes | — | List all available themes | — |

Supported Languages

JavaScript, TypeScript, JSX, TSX, Python, Ruby, Go, Rust, Java, C, C++, C#, PHP, Swift, Kotlin, Scala, SQL, HTML, CSS, SCSS, JSON, YAML, Markdown, Bash, Docker, and more.

Available Themes

| Theme | Background | Style | |-------|-----------|-------| | dracula | #282a36 | Dark | | monokai | #272822 | Dark | | github-dark | #0d1117 | Dark | | nord | #2e3440 | Dark | | one-dark | #282c34 | Dark | | night-owl | #011627 | Dark | | solarized-dark | #002b36 | Dark | | vscode | #1e1e1e | Dark | | github-light | #ffffff | Light | | material-light | #fafafa | Light |

License

MIT