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 write | It means |
|---|---|
SCENE: place, time, weather | Start a new scene with that environment |
CAST: Name = character | Give a character a name (several, separated by commas) |
Name (emotion): words | The 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 line | One after another |
& | At the same time |
WAIT 2s | Pause (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 heart | A small icon above a character's head |
TRANSITION: fade | How this scene changes to the next |
TITLE: / ASPECT: 9:16 / FPS: 30 | Project title, video shape and frame rate |
# note | A 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, dayorSCENE: 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 leftstarts off screen;runs off rightleaves 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 2spauses 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 !orEMOTE: Leo heart: exclaim (!), question (?), heart, anger, sweat, zzz, idea, music note, sparkle, tear.TRANSITION: fadeat 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.