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
| Param | Type | Default | Notes |
|---|
code | string | required | 1-10,000 chars |
language | string | "typescript" | typescript, javascript, python, rust, go, java, cpp, c, html, css, json, bash, sql, markdown, toml |
theme | string or TinteBlock | "one-hunter" | Slug from tinte.dev or inline object |
mode | "dark" \ | "light" | "dark" |
padding | number | 32 | 0-256 |
fontSize | number | 14 | 8-32 |
lineNumbers | boolean | true | |
title | string | "" | Window chrome title (max 100) |
background | string | "midnight" | One of: midnight, sunset, ocean, forest, ember, steel, aurora, none. Hex colors are not accepted. |
format | "png" | "png" | PNG only |
scale | number | 2 | 1-4 (retina) |
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
- Identify the code to screenshot (from file, clipboard, or user input)
- Detect language from file extension or content
- Call the API via curl
- 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
| Extension | Language |
|---|
| .ts, .tsx | typescript |
| .js, .jsx | javascript |
| .py | python |
| .rs | rust |
| .go | go |
| .java | java |
| .cpp, .cc, .cxx | cpp |
| .c, .h | c |
| .html | html |
| .css | css |
| .json | json |
| .sh, .bash | bash |
| .sql | sql |
| .md | markdown |
| .toml | toml |
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, tx2, tx3, ui, ui2, ui3, ac1, ac2, ac_3, pr, sc, nt)
