Script writing

Script cheat-sheet: every rule with examples

One page with every Script-mode rule: scenes, cast, dialogue, actions, places, timing, camera, sound, titles and comments.

Updated 17 October 2026

A complete example first, then every rule.

TITLE: Rex in the forest
SCENE: forest, sunset, rain
MUSIC: adventure, 40%
CAST: Leo = lion, Mia = girl, Rex = trex

Leo enters from left and walks to center
Mia runs to right & waves
Leo (happy): Hello Mia! Want to explore?
Mia (scared): I heard Rex lives here...
WAIT 1s
Rex jumps in from right
CAMERA: shake strong, close-up Rex
Rex (angry): ROAAAR!
SFX: thunder
Mia runs off right
Leo (surprised, whisper): Uh oh.
TRANSITION: fade

The rules

You writeIt means
SCENE: place, time, weatherStart a new scene with that environment
CAST: Name = characterGive a character a name (several, separated by commas)
Name (emotion): wordsThe character says the words with that feeling
Name (emotion, whisper) or (…, shout)Also change the voice style
Name says "words"Another way to write a line
Name <action> <place>The character moves or acts
and or a new lineOne after another
&At the same time
WAIT 2sPause (500ms also works, up to 60 s)
CAMERA: …Camera shot or move
SFX: … / MUSIC: …Sound effect / background music
TEXT: "Chapter 1"Words on screen
EMOTE: Name heartA small icon above a character's head
TRANSITION: fadeHow this scene changes to the next
TITLE: / ASPECT: 9:16 / FPS: 30Project title, video shape and frame rate
# noteA comment; ignored

Scenes

SCENE: place, time, weather. Only the place is required.

  • Times: day, sunset, night (words like morning or dusk work too).
  • Weather: clear, cloudy, rain, storm, snow, fog, wind.
  • Example: SCENE: school, day or SCENE: beach, night, storm.

Cast

CAST: Leo = lion, Mia = girl. The name is what you type in the script; the character is what appears. If you use a name that is not in CAST, StoryToon adds it with a matching character and tells you, so you can choose a different one.

Dialogue

  • Leo: Hello!: a plain line.
  • Leo (happy): Hello!: with a feeling.
  • Leo (scared, whisper): Shh…: a feeling plus a voice style.
  • Feelings: happy, sad, angry, surprised, scared, sleepy, love, thinking, confused, proud, shy, disgusted.
  • Voice styles: whisper (or quietly, softly), shout (or loud, yell), normal.
  • Say verbs work too: Mia asks "Where are we?", Rex shouts "Go away!".

Actions and places

Write the name, then what they do, then where: Leo walks to center, Mia sits on chair, Rex hides behind Leo.

  • Places: left, center, right, back, front, off-left, off-right, near Name, behind Name, on prop.
  • Entrances and exits: enters from left starts off screen; runs off right leaves the screen.
  • Speed: add slowly, quickly, very fast: Leo walks slowly to left.
  • Many words mean the same action: walks, goes, moves, strolls, steps → walk; runs, rushes, dashes, races → run.
  • The full list is in All actions and emotions.

Timing

  • A new line, or the word and, means "after the previous one".
  • & means "at the same time": Mia waves & Leo nods.
  • WAIT 2s pauses everything for two seconds.
  • Lines last exactly as long as their voice, plus a short natural gap.

Camera

CAMERA: close-up Rex, CAMERA: wide, CAMERA: shake strong, CAMERA: follow Mia.

  • Shots: wide, medium, close-up, extreme close-up.
  • Moves: pan, zoom, follow Name, shake (light, medium, strong).
  • Two in one line run together: CAMERA: shake strong, close-up Rex.

Sound and music

  • SFX: thunder, SFX: door knock: a sound effect at that moment.
  • MUSIC: adventure, 40%: background music for the scene at 40% volume. Moods include happy, sad, adventure, scary, calm, funny and epic.

Titles, emotes and transitions

  • TEXT: "Chapter 1": a title on screen for a few seconds.
  • EMOTE: Mia ! or EMOTE: Leo heart: exclaim (!), question (?), heart, anger, sweat, zzz, idea, music note, sparkle, tear.
  • TRANSITION: fade at the end of a scene: cut, fade, slide, zoom, iris, wipe.

Editor help

  • Names are blue, actions green, feelings orange.
  • Start typing a name and press Ctrl+Space for suggestions; inside ( ) you get feelings.
  • Unknown words get a red underline and a suggestion such as jogs → did you mean run? One click fixes it. See Fixing red underlines.

Ready to make your first cartoon?

Write a few lines, press Play, and export a video. The Free plan needs no card.

Make your first cartoon free