Docs / Getting started / Your first board

Your first board

Everything in Torax happens on a board. A board is a canvas of nodes — script, episodes, character, stills, shots, sound, the cut — each with inputs and outputs. You wire them in the order your story needs and re-run only the branch that changed.

The fastest way in is the prompt on the homepage. Pick Generate video or Write script, type, press Generate: you land on a new board with that one node centred and focused, your text already in its composer.

  • Or open the Studio and press Create new canvas (or the N key).
  • Type into the frame and press the round generate button, or ⌘/Ctrl + Enter.
  • Drag from the node’s output port onto the next node’s body to wire it, or drop the wire on empty board to insert a new node already connected.
Tip

A node runs on what is wired into it. Change something upstream and re-run the branch below — the rest of the board stays exactly as it was.

Signal Lost — S1 Live demo board Drag to pan · ⌘ scroll to zoom Open in the canvas ↗

The Studio

The Studio is the library. The most recently edited board leads the grid; filter All / Series / Shared with me, sort by last edited, name or node count, and switch between grid and list. A rendering board reports episodes done rather than a bare percentage.

  • Templates — starter graphs you can open as a new board.
  • Render queue — what the farm is chewing on, with a Retry on anything that failed.
  • Bell — review requests and replies, render completions and comments, shared with the canvas.
  • Credits — the meter in the sidebar reflects what the canvas spent on your last visit.

Nodes, ports & wires

Every node is a frame whose aspect follows its own setting: the result fills it and the composer sits inside as an overlay — reference chips for whatever is wired in, a prompt box, the per-type pills (count · model · aspect · 2K / length / voice), and the round generate button. Idle, running and filled all share the same shape, so a card never jumps between layouts.

Ports are typed. Text flows into the story nodes; picture flows into everything visual; the type’s own output flows out. You do not have to hit the little port circle — drag a wire onto a node’s body and it connects on the side opposite where you started.

  • Model chip — the strip under the label (“Model · Kling 2.1”) opens the node’s model list; picking one is a single undo step.
  • Open — the button in the label strip, a double-click on the card, or the right-click menu opens the node’s panel, editor or viewer.
  • Toolbar — a selected card floats Run, Duplicate, Lock, Comment, Colour, Delete and — on video shots — Send for review.

Adding nodes

The inserter opens from the + in the dock, the N key, a double-click on empty board, right-click → Insert here, or a wire dropped on bare board. It remembers where it was summoned from, so the new node lands under the cursor — and if a dragged wire opened it, the node arrives already connected in the direction you dragged.

The category tabs are the six groups — Story, Media, Image, Video, Audio, Output — plus Recent. ↑ ↓ move, Enter inserts, Esc closes.

Workflow & Storyboard

Workflow is the graph. Storyboard is the same board read as an ordered shot list: every video-capable node, sorted left to right, with its still, model, length, run state and review state. Filter to Awaiting review or Approved; click a shot and you land on it on the board.

Tip

Switching views only toggles what is visible. The viewport never moves, so coming back lands exactly where you left.

Frames, notes & ink

The dock holds the placement tools: Select, Pan (or hold Space), Draw (lime ink on its own layer), Frame (drag a labelled group frame — dragging it moves its contents), Text, Sticky note, Comment (a pin on the board or on a node’s shoulder), Folder (wraps the selection in a collapsible container) and Search (find a node, fly to it, flash it). Items live in the same undo history as nodes.

Zoom with a pinch or Ctrl + wheel; a bare wheel or two-finger scroll pans. The zoom pill steps in ×1.25, resets to 100 % and fits every node clear of the chrome. Range is 10 %–300 %; below 40 % cards simplify to labelled blocks so a big board stays fast.

Undo & versions

History is per gesture, not per frame: ⌘Z returns a whole drag, a whole edit, a whole review action; ⇧⌘Z redoes. A press that never became a drag costs no undo step. Versions in the top bar lists the board as it stood earlier; Restore swaps the live graph for that state, and undo still brings the current one back.

Story nodes

Story Script — Script from story, Script from character, or Write script yourself. Paste a story, a logline or a synopsis; the result opens in a screenplay editor where every line has a kind — slug, action, character, dialogue. Enter adds the line a screenwriter expects next, Tab cycles the kind, Save writes back to the node. Models: Torax Writer 2, Claude Sonnet 4, GPT-4.1, Gemini 2.5 Pro.

Episode Splitter — Split on plot beats. The episode panel has a count stepper and a target length; click a title to rename it and the board follows. Each episode can be dropped onto the board as its own filled script node under the splitter. Optional notes steer the split.

# splitter notes
end every episode on the phone ringing

# character sheet — name first, then the look
Layla, 34, tired eyes, dispatcher’s headset, never takes off the wool coat

Character Sheet — Build from description or Build from a reference still. The sheet is one face in sixteen crops; the character name is whatever comes before the first comma. Every image and video node wired downstream reads it. Models: Flux 1.1 Pro, Nano Banana, Seedream 4, GPT Image 1.

Upload & Stock

Upload — drop files on the frame, on bare board (an Upload node appears where they land), or into a generator node to make the file its payload. Pick from project assets lists what the project already holds. Stock — search footage and stills; sources are Pexels, Artgrid and Storyblocks.

Image nodes

Image Generator — Text to image, Image to image, Upload local. Pills: count, model, aspect (9:16 · 1:1 · 16:9), 2K. Extra variants land as sibling frames fed by the same inputs. Models: Flux 1.1 Pro, Nano Banana, Seedream 4, GPT Image 1, Imagen 4.

Image Upscaler — wire a still in and pick 2× or 4×. The result shows a before/after line you drag, on the card or in the viewer. Models: Magnific Precision, Topaz Gigapixel, Real-ESRGAN.

Video nodes

Video Generator — First-frame video, First/last frame video, or Upload local video. The prompt is camera and motion: “slow push-in, rain on glass, the lamp flickers”. Play and scrub on the card; open the viewer for the bigger picture, the motion note, Send to compose, Add voice and the review block. Models: Kling 2.1, Veo 3, Seedance 1.0 Pro, Hailuo 02, Wan 2.2.

Director Console 3D — Block the scene in 3D, Capture multi-angle shots. Cameras and a slider over a set; every capture lands in the strip on the node and can feed the video nodes. Engines: Torax Scene 3D, Hunyuan3D 2, Trellis, MID.

Tip

Only finished video shots can go for review. Send them before they go anywhere near the cut.

Audio nodes

Voice Generator — Cast a voice, Read the scene aloud. Pick a voice (Arabic and English casts are built in), give it the lines — a wired script hands over its dialogue automatically. Models: ElevenLabs v3, Torax Arabic TTS, Fish Audio, Cartesia Sonic.

Audio to Video — Drive video from audio. Wire a voice and a still or a shot, add performance notes — “holds eye contact, small nod on the last line”. Models: OmniHuman, Hedra Character 3, LatentSync.

Video compose

Video Compose — Assemble approved shots. The cut is read off the board: every finished video node, left to right. When any shots are approved, compose cuts from those; otherwise it assembles every finished shot and says so. Open it for the shot bin (with each shot’s review pill), the strip — drag a block to reorder, play the transport — and export. Renderers: Torax Cut, FFmpeg.

Send for review

A finished video shot can be sent to a reviewer from three places: the paper-plane button in the card’s floating toolbar, right-click → Send for review, or the Review block in the shot’s viewer. Pick a collaborator — editors and reviewers on the board — or Approve it myself.

  • Awaiting — the card shows Awaiting LH with a live dot; the bell logs “You sent … to Lina Haddad”. While pending you can withdraw the request or approve it yourself.
  • Approved — a lime badge on the card, “Lina Haddad approved …” in the bell, and the shot counts for video compose.
  • Changes — a red-edged badge, the reviewer’s note in the viewer, and the button relabels Send for review again.

The storyboard shows the same state as pills and filters on it; compose shows it in the shot bin. Review notices persist across boards and appear in the Studio bell too.

Credits & models

Every generate button shows its credit cost before you press it. A run that fails refunds itself; you pay for what you keep. The Studio sidebar meter reflects what the canvas spent, and Upgrade in the top bar opens the plans — Free, Beta and Studio differ in credits, render quality and seats, never in which nodes or model chips you can use.

Keyboard shortcuts

  • N — open the inserter at the centre of the board
  • ⌘/Ctrl + Enter — run the composer you are typing in
  • ⌘Z / ⇧⌘Z — undo / redo, one gesture at a time
  • ⌘A select all · ⌘D duplicate · ⌘C / ⌘V copy and paste the selection
  • Delete / Backspace — remove the selection (edges go with the nodes)
  • Arrows nudge 8 px · Shift + Arrows nudge 1 px
  • Space (hold) — pan · Ctrl + wheel or pinch — zoom at the cursor · Alt + double-click zoom in, Alt + Shift + double-click out
  • Esc — clear the selection, close the top-most panel, drop a marquee
  • Double-click a card to open it; double-click its label to rename it; double-click empty board to insert
Was this helpful?