A complete example
Paste this into Script mode and press Play. Every line is explained below.
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.
The rules
| You write | It means |
|---|---|
SCENE: place, time, weather | Start a new scene, e.g. SCENE: classroom, day or SCENE: forest, night, rain. |
CAST: Name = character | Give characters names: CAST: Leo = lion, Mia = girl. |
Name (emotion): words | The character says the words with that feeling: Mia (happy): Hello! |
Name (emotion, whisper) | Also change the voice style: whisper or shout. |
Name action place | The character moves or acts: Leo walks to center, Mia sits on chair. |
and / a new line | One thing after another. |
& | At the same time: Mia waves & Leo nods. |
WAIT 2s | A pause. |
CAMERA: … | Shots and moves: wide, medium, close-up, pan, zoom, follow, shake. |
SFX: … / MUSIC: … | A sound effect, or the background music and its volume. |
TEXT: "Chapter 1" | Words on screen. |
TRANSITION: fade | How this scene changes to the next: cut, fade, slide, zoom, iris or wipe. |
# note | A comment. StoryToon ignores it. |
Write your script in three steps
- Set the scene and cast. Start with a SCENE line for the place and a CAST line that names your characters.
- Write actions and lines. One line per thing that happens: who moves, who speaks and how they feel. Use & for things that happen at the same time.
- Fix red underlines and play. Unknown words get a red underline and a suggestion. Click the fix, press Play to watch, then Export.
Where characters can go
left, center, right, back, front, off-left, off-right, near Name, behind Name, on prop (e.g. "sits on chair"). Characters entering "from left" start off-screen and walk in.
The 12 emotions
Write an emotion in brackets before the colon: Leo (proud): I did it!. You can combine one emotion with a voice style: (scared, whisper).
- happy
- sad
- angry
- surprised
- scared
- sleepy
- love
- thinking
- confused
- proud
- shy
- disgusted
All 61 actions and the words for them
Many words mean the same action, so you can write naturally. If StoryToon does not know a word it suggests the closest one by spelling (for example jogs → run), and you can add your own words.
| Action | Words that work |
|---|---|
| walk | walk, go, move, stroll, step, head |
| run | run, rush, dash, race, sprint, hurry |
| sneak | sneak, tiptoe, creep, prowl, slink, sneak around |
| march | march, parade, stride, strut |
| skip | skip, prance, frolic |
| jump | jump, leap, spring, jump up, jump around |
| hop | hop, bounce, bound |
| fall | fall, fall down, fall over, trip, tumble, stumble |
| get up | get up, rise, get back up, get to feet |
| turn | turn around, turn, spin, spin around, turn round, look |
| enter | enter, come in, walk in, step in, arrive, appear |
| exit | exit, leave, go away, walk away, walk out, go out |
| fly | fly, flutter, soar, glide, flap, hover |
| swim | swim, paddle, dive, float |
| climb | climb, climb up, scramble up, scale, clamber |
| crawl | crawl, slither, wriggle, crawl around |
| wave | wave, wave hello, wave goodbye, wave bye, wave hand |
| point | point, gesture, indicate, count, show |
| clap | clap, applaud, clap hands, wash hands, scrub hands, rub hands |
| nod | nod, nod head, agree, listen, smile, grin |
| shake head | shake head, disagree |
| shrug | shrug, shrug shoulders |
| thumbs up | give thumbs up, give thumb up |
| bow | bow, bow down, curtsy, curtsey, kiss, thank |
| salute | salute |
| facepalm | facepalm, face palm, slap forehead |
| scratch head | scratch head |
| hands on hips | put hands on hips, stand with hands on hips |
| cross arms | cross arms, fold arms |
| cover eyes | cover eyes, hide eyes, close eyes |
| cover ears | cover ears, block ears, plug ears |
| laugh | laugh, laugh out loud, cackle, guffaw, burst out laughing |
| cry | cry, weep, sob, bawl, burst into tears, tear up |
| celebrate | celebrate, cheer, rejoice |
| dance | dance, boogie, groove, twirl, play, play around |
| tremble | tremble, shake, shiver, quiver, shudder, cower |
| stomp | stomp, stamp, stamp feet, stomp feet, stomp around |
| think | think, ponder, wonder, consider, think hard, muse |
| yawn | yawn, stretch |
| sleep | sleep, fall asleep, doze, nap, snooze, doze off |
| faint | faint, pass out, collapse, swoon, keel over |
| sit | sit, sit down, take seat, have seat |
| stand up | stand up, stand |
| lie down | lie down, lay down, lie, recline |
| pick up | pick up, pick, grab, take, lift, collect |
| put down | put down, drop, place, set down, put |
| give | give, hand, pass, offer, hand over, share |
| eat | eat, munch, chew, bite, nibble, snack |
| drink | drink, sip, gulp, slurp |
| read | read, study, browse |
| throw | throw, toss, hurl, fling, chuck, lob |
| kick | kick, boot, play football, play ball, kick ball |
| talk | talk, chat, chatter, converse, babble, mumble |
| whisper | whisper, murmur |
| shout | shout, yell, scream, holler, cry out, call out |
| sing | sing, chant, croon, serenade |
| roar | roar, growl, snarl, howl |
| bark | bark, woof, yap, yelp |
| tail wag | wag tail, wag |
| peck | peck, peck at |
Character names in CAST
After the = write a character word like lion, girl, doctor or trex, or the exact id shown on each character page (for example kid_girl_1). Places use ids like forest, classroom or living_room; see all places.
Tips for better cartoons
- Keep lines short: one or two sentences each read and sound better.
- Give every line an emotion; it changes the face, the pose and the voice.
- Use
WAIT 1sbefore a surprise to build suspense. - Let the automatic camera follow the speaker, then add a
CAMERA: close-upfor big moments. - Use the 9:16 shape (
ASPECT: 9:16) for Shorts and Reels.