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

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

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, tx_2, tx_3, ui, ui_2, ui_3, ac_1, ac_2, ac_3, pr, sc, nt)