PteroPrompter Docs Log in

The rig

Everything describing the machine in front of you is stored on that machine, not on your account. A studio desktop and a travel laptop have different socket addresses, a different distance to the glass, and possibly a different frame rate. Syncing those between them would break a take rather than help.

On the glass

  • Eyeline

    Drag the handle to put the reading line where the lens is. Double-click resets it.

    Tokens fire against this line, so cue timecodes follow it wherever you put it.

  • Script size

    Between 28 and 68 pixels.

    Set by how far you sit from the glass, not by taste.

  • Mirror

    Flips the script horizontally.

    For beam-splitter rigs. It flips the script, never the controls.

  • Confidence monitor

    OBS's virtual camera, faint and centred on the eyeline. Right-click for size and opacity.

    Check framing without breaking eye contact with the lens.

What you plug in

Both are optional, and both fail softly. The prompter is designed so a take never depends on either being there.

OBS

ws://127.0.0.1:4455

Tools → WebSocket Server Settings, in OBS.

With it
Recording control, and cue timecodes pinned to the recording itself.
Without it
Cues still log against an internal clock. Every marker is simply offset by one constant.

Speech sidecar

http://localhost:7357/events

Run prompter-ears on the machine reading the script.

With it
Follow mode: the scroll tracks what you actually say, and a pause releases when you read on.
Without it
The scroll coasts at your set pace, which is the behaviour you would have had anyway.
Not yet proven on hardware. The OBS integration is covered by tests against a simulated socket, and speech follow by tests against word lists. Neither has been through a real take. Treat the first one as a rehearsal.

Reading the lock

The dot beside the Follow button is the honest signal. Losing the lock is not a failure — it simply means the scroll is back to running at the pace you set.

  • OffFollow mode is not enabled.
  • No sidecarNothing is listening at that address.
  • CoastingConnected, but the last match has gone stale.
  • LockedFollowing your voice through the script.
  • HeldA token is holding. Read on to release it.

Keys

  • spaceplay or pause
  • ↑ ↓reading pace
  • ← →previous or next section
  • Ffollow mode
  • Mcue log
  • Ddiagnostics

Want to run your next take on this?

PteroPrompter is in early access. Leave an address and we'll be in touch when the first takes ship.