railly/tinte/ray

Ray - Code Screenshots

Generate code screenshots by calling the ray.tinte.dev API.

API

POST https://ray.tinte.dev/api/v1/screenshot
Content-Type: application/json

Parameters

Notes

• background: "none" returns a transparent RGBA PNG. Useful when you want to composite the screenshot onto a custom background.
• Returned PNGs always include some transparent margin around the window for the drop shadow, even with padding: 0. If you're compositing the result, trim that halo first (e.g. magick input.png -trim +repage output.png).
• Long snippets can take 30-60+ seconds to render. Use a per-request timeout when calling from scripts or agents.

Workflow

1. Identify the code to screenshot (from file, clipboard, or user input)
2. Detect language from file extension or content
3. Call the API via curl
4. Save the PNG and open it

Example

curl -s -X POST https://ray.tinte.dev/api/v1/screenshot \
  -H 'Content-Type: application/json' \
  -d '{
    "code": "const greeting = \"Hello, world!\";",
    "language": "typescript",
    "theme": "one-hunter",
    "title": "hello.ts"
  }' -o screenshot.png && open screenshot.png

Language Detection

Themes

• Default: "one-hunter" (Vercel-inspired dark theme)
• Any slug from tinte.dev: "github-dark", "dracula", "catppuccin", etc.
• Inline TinteBlock object with 13 semantic colors (bg, tx, tx_2, tx_3, ui, ui_2, ui_3, ac_1, ac_2, ac_3, pr, sc, nt)