Paint a photo with Todrawn Scribe
scribe_paint_imagePaint a local PNG or JPEG as a Todrawn pen-stroke drawing: creates an underpaint, replays colored strokes as a video, and returns a shareable link while the image stays local.
Instructions
Paints a local photo or picture (PNG or JPEG) as a Todrawn Scribe drawing: an underpaint first, then thousands of coloured pen strokes, replayed by the pen as a video. The image is processed on this machine and never uploaded; the returned link carries only the strokes. Long paintings are capped at 180 s of playback. Previewing is free and needs no account. Exporting the MP4 needs a free Todrawn account: the Free plan allows 5 exports per UTC day and ends each video with a "Made with Todrawn Scribe" card; Premium has unlimited exports, makes the card optional and also exports 2160p (4K) and 60 fps.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"imagePath": "<imagePath>"
},
"name": "scribe_paint_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pen | No | Pen width shapes the painting: fineliner (default) is the finest, marker the boldest. Chalk draws a grainy chalk line and is meant for background: "dark". | |
| aspect | No | Artboard: landscape 16:9, portrait 9:16, square 1:1, feed 4:5. Defaults to the one closest to the image's shape. | |
| detail | No | Stroke budget: low ~1200 strokes, medium ~2000 (default), high ~2800. More detail is more faithful and plays longer. | |
| locale | No | Language of the Scribe interface the link opens. Defaults to en. | |
| density | No | Spacing of the board pattern's marks, 16 to 192, even numbers only (default 28). Larger is sparser. | |
| pattern | No | Marks printed on the board behind the writing: dots, lines, grid, staff, vertical lines or blank. | |
| imagePath | Yes | Path to a local PNG or JPEG file. Relative paths resolve against the server's working directory. | |
| background | No | dark board or light paper. | |
| cameraTilt | No | Camera angle above the board in degrees: 20, 25, 30, 35, 40, 45, 50, 55, 60, 65, 70, 75, 80, 85, 90. 40 is the standard view, lower is flatter and shows more depth, 90 looks straight down. Applies to the 3D pen view only (its preview and its export); the flat 2D view ignores it. | |
| cameraZoom | No | Camera framing of the 3D pen view (its preview and its export) in percent: 75, 100, 125, 150, 175, 200; 75 shows the most board, 200 follows the pen closest. The flat 2D view ignores it. Not the same as a passage's zoom. | |
| cameraRotation | No | Camera rotation around the board in degrees: -45, -40, -35, -30, -25, -20, -15, -10, -5, 0, 5, 10, 15, 20, 25, 30, 35, 40, 45. 0 looks straight on, negative moves the camera to the left of the board, positive to the right. Applies to the 3D pen view only (its preview and its export); the flat 2D view ignores it. | |
| speedMultiplier | No |