rayshot

Generate beautiful code screenshots from ray.so via the command line.

Installation

# Clone and install
git clone https://github.com/kristianfreeman/rayshot.git
cd rayshot
npm install

# Link globally (optional)
npm link

Usage

# Basic usage - pass code directly
rayshot "const x = 1;" -o screenshot.png

# From a file
rayshot ./snippet.ts --output screenshot.png

# With options
rayshot "console.log('hello')" --theme vercel --language javascript --name app.js

# Pipe from stdin
cat myfile.py | rayshot - --language python -o output.png

# Light mode
rayshot "const x = 1;" --light --theme candy

Options

Option	Alias	Description	Default
--theme	-t	Theme name	cloudflare
--language	-l	Syntax highlighting language	typescript
--output	-o	Output file path	./rayshot.png
--name	-n	Filename shown in header	none
--padding	-p	Padding in pixels	32
--dark	-d	Dark mode	true
--light		Light mode
--list-themes		List all available themes
--list-languages		List all available languages
--help	-h	Show help

Themes

Partner Themes

• cloudflare - Cloudflare (orange/dark)
• vercel - Vercel (black/white)
• supabase - Supabase (green/dark)
• tailwind - Tailwind CSS (blue)
• openai - OpenAI (black/green)
• stripe - Stripe (blue/purple)
• prisma - Prisma (teal)
• clerk - Clerk (purple)
• mintlify - Mintlify (green)
• elevenlabs - ElevenLabs (purple)
• resend - Resend (black/white gradient)
• triggerdev - Trigger.dev (purple)
• nuxt - Nuxt (green)
• browserbase - Browserbase (orange)
• gemini - Google Gemini (blue)

Community Themes

• noir, mono, breeze, candy, crimson, falcon, meadow, midnight, raindrop, sunset, bitmap, ice, sand, forest

Run rayshot --list-themes for the full list.

Languages

Supports all major languages including:

typescript, javascript, python, swift, go, rust, java, kotlin, cpp, c, csharp, ruby, php, shell, sql, json, yaml, html, css, markdown, and more.

Run rayshot --list-languages for the full list.

Examples

Tweet-ready Cloudflare code snippet

rayshot 'const handler = async (req: Request) => {
  return new Response("Hello from Workers!");
};' --theme cloudflare --name worker.ts -o tweet.png

Dark Vercel-themed React component

rayshot ./Component.tsx --theme vercel --dark -o component.png

Python with Supabase theme

rayshot "def hello():
    print('Hello, World!')" --theme supabase --language python -o hello.png

How it works

rayshot uses Playwright to:

1. Open ray.so with your code and settings encoded in the URL
2. Wait for the code frame to render
3. Click the "Export" button
4. Save the downloaded PNG

Requirements

• Node.js 18+
• Chromium (automatically installed by Playwright)

License

MIT

Credits

• ray.so by Raycast - The beautiful code screenshot tool
• Built for making tweet-worthy code snippets