Create a Todrawn Scribe video
scribe_create_videoTurn code or text into a handwritten-pen video project and get a link to preview it and export the MP4 in the studio.
Instructions
Turns code or text into a Todrawn Scribe project: a video of a pen writing it out by hand. Returns a link that opens the Scribe studio with the project loaded, where the person previews it and exports the MP4. Optional segments give chosen passages their own speed, size, pen, pause or zoom; pattern and density set the board; cameraZoom, cameraTilt and cameraRotation set the 3D camera. Give the link to the person; do not try to download a video from it. 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": {
"text": "<text>"
},
"name": "scribe_create_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fps | No | Export frame rate: 24, 30, 60. 60 needs a Premium plan; on other plans the studio exports at 30 fps instead. | |
| pen | No | Pen for the whole video: ballpoint (default), marker, fineliner, pencil or chalk. Chalk draws a grainy chalk line and is meant for background: "dark". | |
| text | Yes | The code or text to draw, exactly as it should appear. | |
| aspect | No | landscape 16:9 (default), portrait 9:16 for Shorts/Reels/TikTok, square 1:1, feed 4:5. | |
| layout | No | auto scrolls tall aspects and pages wide ones. | |
| locale | No | Language of the Scribe interface the link opens. Defaults to en. | |
| timing | No | reading: paced by words per second (default); pen: paced by pen travel. | |
| 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. | |
| language | No | Syntax colouring: js, ts, py, java, clike, sql, html, css, bash, go, rust, plain. Common names (typescript, python, c++, shell, markdown) are accepted. Defaults to plain. | |
| markdown | No | Interpret Markdown in plain text (default true). | |
| segments | No | Passages with their own speed, size, pen, pause or zoom, for example to slow down the key line. Each one selects text with match or fromLine/toLine and sets at least one of speed, size, pen, pauseAfter, zoom. At most 500; later ones win where they overlap. | |
| colorMode | No | syntax colours per token, or one solid ink colour. | |
| 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. | |
| readingWps | No | Words per second when timing is reading. | |
| resolution | No | Export resolution: 720p, 1080p, 2160p. 2160p needs a Premium plan; on other plans the studio exports at 1080p instead. | |
| solidColor | No | Ink colour as #rrggbb when colorMode is solid. | |
| 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 |