Skip to content

FollowSpot

A teleprompter that listens, running Whisper on your own machine.

2026

Read your script out loud and the highlight follows you. Skip a sentence, flub a word, or ad-lib a little and it keeps going. Stop talking and it stops too.

The listening is a whisper.cpp model you choose, served on 127.0.0.1, so your audio never leaves your laptop. I built it because I have the energy of a theater kid and can't memorize lines, and the prompter apps I had didn't let me pick the model or set up the screen the way I wanted.

If you record with Screencast Director while FollowSpot is open, the draft edit keeps only your last take of each script line.

Try it

brew install whisper-cpp
git clone https://github.com/JoeKarlsson/followspot.git && cd followspot
./followspot download small.en
./followspot download vad
./followspot your-script.md

Scripts are plain Markdown. Stage directions are shown dimmed and never listened for:

# Episode 12 notes (ignored)

---

*[Wide shot. Lights up.]*

Hey, welcome back. Today I'm going to show you something I built
because I can't memorize lines.

---

Shot list down here is ignored too.

Screenshots

A wide column makes your eyes sweep on every line. A narrow one centered on the lens hides it.

FollowSpot with a wide text column stretching most of the way across the screen
Default: wide column
FollowSpot with a narrow text column centered on screen, three or four words per line
How I run it: 30% column over the lens

How it's made

JavaScript, whisper.cpp, Whisper, Web Audio, Bash

Every quarter second, as long as you're talking, the page sends the last 3.5 seconds of audio to a whisper.cpp server on your own machine, with the last 30 words of the script as a hint for names. It matches the newest words it hears against the script around your place, and it only jumps back for a retake when at least 4 words match.

WHEN IT ISN'T SURE YOUR MIC quiet? sends nothing LAST 3.5 S every 0.25 s, plus last 30 script words whisper-server whisper.cpp, 127.0.0.1 text SCROLL line at lens height HIGHLIGHT to the last match MATCH newest 14 words heard vs 12 back, 60 ahead RETAKE backs up only with 4+ matched words LOST no match for 1.5 s: drifts ahead slowly QUIET you stop, it stops
WHEN IT ISN'T SURE YOUR MIC quiet? sends nothing LAST 3.5 S every 0.25 s, plus last 30 script words whisper-server whisper.cpp, 127.0.0.1 text MATCH newest 14 words heard vs 12 back, 60 ahead HIGHLIGHT to the last match SCROLL line at lens height RETAKE backs up only with 4+ matched words LOST no match for 1.5 s: drifts ahead slowly QUIET you stop, it stops

If you liked this project, consider sharing it on Hacker News, Bluesky, LinkedIn, or X.

← All works