Help

Everything you need to rehearse with Cuesworth. Can't find your answer? Email support@cuesworth.com.

Getting started

Tap Upload a script (PDF) and choose your script from Files, iCloud Drive, or wherever you keep it. A typed PDF takes seconds; a scanned one takes a few minutes, because every page is read like a photograph.
Choose your character from the list (the biggest parts come first) and tap Start rehearsing. Playing more than one part? Tap Playing more than one part? and tick the others: their lines join yours in the order of the script, each with its character's name, so you can run the whole show from beginning to end.
Tap Begin rehearsal, then tap the line you want to start from (or just start with the highlighted one). Cuesworth reads its cue, and you're off. Tapped the line first? The Begin rehearsal button lights up to remind you, and the cue comes once you tap it.
To jump to another act or page, tap the act or the page number at the top of the script.
Forgotten a command? Tap Commands, beside Begin rehearsal, for a quick look. Help, next to it, sums up what you can tap.

The first time, Cuesworth asks to use the microphone and speech recognition. Both run on your device. It may also download Apple's English speech model, once.

While you rehearse

The word you just said is in bold, so you can always see where you are.
Words you drop or change are marked in red, with a soft sound (you can turn the sound off: Settings, at the top right, then Mistakes). Starting a line again clears its marks.
End rehearsal (the same button, while Cuesworth listens) switches the microphone off, once he's had the last word.
Skip a line (say the next one by mistake) and Cuesworth stops you: “You skipped a line,” then its cue, so you can say it. The line you skipped is marked red. (A very short line, like “Yes.”, is only marked.)
Words you add are marked too, without moving the line: a small ^ in the gap where you added something, and a note under the line: “added ‘down’”, or “said ‘house’ for ‘horse’” when you swapped a word.
When you finish a line, Cuesworth reads the next cue by itself. Pause to think whenever you like: it waits.
Change how fast cues are read, or turn them off: Voices → Cues.
Test yourself: Settings → Show my lines, then First letters (only each word's first letter) or Hidden. Each word appears as you say it, or when Cuesworth gives it to you; a missed word shows in red; a line you've finished shows in full until you start it again.
Lines hard to read? Make the script bigger: Settings → Text (Smaller to Largest). It starts at your iPhone's own text size (Settings → Display & Brightness → Text Size), and each device remembers its own.

Line notes: what you've been getting wrong

Like a stage manager's line notes. Every slip goes in, as it happens: a word you dropped, one you called for, one you added or changed, a line you skipped. Saying a line again doesn't wipe its notes: they're there to show you what keeps tripping you up.

When you tap End rehearsal, a small Line notes button appears at the top, beside the button: a note with a number on an iPhone (how many notes you haven't seen), “Line notes · 3 new” on an iPad. Tap it and the day's notes open at the new ones.
Each line with a slip is there in full, under its cue, the words you missed in red and a small ^ where you added one, with what happened underneath. Tap a note to go to that line and work on it.
A page a day: each run of the day under the time it started, the newest at the bottom. Flip back to earlier days with ‹ and › (the last 30 days are kept).
A line you slipped on before says so: “Also noted yesterday, Mon”. Those are your trouble lines.
Say “Read me my notes” and Cuesworth reads you the new ones (in Audio only, he reads them whichever way you ask). For long speeches he reads just the sentence with the slip.

Audio only: rehearse with the phone in your pocket

On a run, at the gym, or walking: tap Audio only at the top of the script. The screen goes black and Cuesworth keeps listening, reads your cues and prompts you as usual. Headphones are best.

Put the phone in your pocket: its screen switches off by itself, as during a phone call.
Don't press the side button. That locks the phone, and Cuesworth stops until you unlock it.
Double-tap the black screen to come back to the script.
If a minute goes by without your lines, Cuesworth asks “Still there?”. With no answer, he says “Stopped listening.”, the microphone switches off, and the phone can lock itself as usual.

Voice commands

Say these out loud while you rehearse. Cuesworth never takes your own lines for a command: if “Line!” is part of a line you're about to say, it's taken as your line. “Line, please” always works.

Say	What happens
“Line!” or “Line, please”	The whole sentence you're in, from its start: say it from there. Say it again for the next sentence.
“Give me a hint” (or “give me a clue”, or just “Clue!”)	Just one more word. Say it again for another.
“Give me the line” (or “…the whole line”)	The whole line from the start.
“Give me the rest”	The line from where you stopped.
“Give me the sentence”	Just the sentence you're in.
“Next sentence” / “Previous sentence”	The sentence after or before, whole (also “give me the next sentence”).
“Next line” / “Previous line”	Move to the next or previous line of yours and hear it, whole (also “give me the next line”).
“Cue line”	Hear the cue again. Also “next cue line” and “previous cue line”.
“Go two cue lines back”	Or forward, any number up to 99: Cuesworth reads that line's cue.
“Go two lines back”	Or forward, up to 99 of your lines: you hear the line you land on, whole.
“Go to the top of act two”	Also “…of scene three”, “go to act four”, or “go to the top” of the act or scene you're in.
“Read me my notes”	Cuesworth reads your new line notes: each line with a slip, and what it was.
“Show me my notes” (or “Line notes”)	The Line notes card. (In Audio only, Cuesworth reads them.)
“What did I miss?”	Cuesworth reads the words marked red in the line you're saying, or the one you just finished, and any you added or swapped.
“Repeat this line”	Say the line you're on (the highlighted one) again and again: each time you finish, its cue comes round again. Each time you say it clean, less of it shows (first letters, then nothing); a slip brings the words back. (Settings → Repeating a line: or the same each time.) “Stop repeating” carries on to the next line; moving anywhere else ends it too. “Put it on a loop” works as well.
“Repeat the last line”	The same, for the line before: the one you just finished.
“Hold, please”	Cuesworth stops following you, so you can try any line you like (a note at the top says “On hold”). “Continue, please” takes you back to the line you were on, with its cue; any other command ends the hold too. On hold, say “Line, please” for a prompt.
“Stop!”	Stops Cuesworth mid-sentence.

Fixing lines, cues and names

Edit a line or cue: press and hold the line, then choose Edit line or Edit cue lines. You can always go back to the original.
More of the scene before your cue: press and hold your line, choose Edit cue lines, then tap + Add a cue line before. Cuesworth fills in the speech before the cue from the script, with who says it; tap again for the one before that, back as far as your own previous line. Use the whole speech gives you all of the cue's speech, not just its end. Cuesworth reads them in order, with a short pause between speakers.
A word that keeps getting marked though you said it (often a name): tap the red word and choose Teach Cuesworth how I say it. Say the words shown when asked, three times (each time from a different line with that word), and Cuesworth recognizes it from then on. Or choose Stop marking it.
A line that's missing: press and hold the line before (or after) it and choose More…, then Add a line. Type your line and, if it has one, its cue. It's numbered from the line before it (12a after line 12, 0a before line 1), so no other line's number changes. "Not my line" removes it again.
A line that isn't yours (one of the "ALL" lines you're not in, say): press and hold it and choose More…, then Not my line. It's taken out of your list, and if someone else now says it just before your next line, it becomes that line's cue.
Words you've taught, words you've chosen not to mark, and lines you've taken out are listed at the bottom of the rehearsal screen. Tap one to undo it.

Voices

Cuesworth's voice is his own, a British voice that comes with the app and works offline, right on your iPhone or iPad. The other characters read their cues in voices of their own: Cuesworth chooses one for each of them (a woman's or a man's, from their name, with the best voices for the biggest parts), and you can change any of them.

Open a script and tap Voices at the top right.
Choose the cast's accent, American or British, and change any character's voice. Tap ▶ to hear one. Your choices are kept for that script, on that device.
Cuesworth's own voice can be changed there too: another of the app's voices, or one of Apple's voices on your device.

More of Apple's voices are free in your device's Settings → Accessibility → Read & Speak → Voices → English; their Enhanced and Premium versions sound far more natural. The app's voices are Kokoro, by hexgrad (Apache 2.0).

Moving scripts to your other iPhone or iPad

On the home screen, tap Export under a script, or Export all.
Send the file to your other device: AirDrop, Messages, Mail or Files.
On the other device, open the file (AirDrop puts it in Files → Downloads), tap Share → Cuesworth, then Import it.

Everything comes along: your edits, mistake marks, taught words and settings. If the same script is already on that device, it's replaced; other scripts are left alone.

When a script doesn't come out right

Scripts come in many layouts, and Cuesworth is still learning some. If your character is missing, or lines look wrong, tap Get help under the script. Describe the problem, and choose whether to include the script. We'll teach Cuesworth your script's layout and send you back a file that fixes it, usually with the improvement going to everyone in the next update.

What you need

An iPhone or iPad with iOS 26 or later. Cuesworth works offline once it's set up.