---
title: "FollowSpot"
description: "FollowSpot: A teleprompter that listens, running Whisper on your own machine."
url: https://www.joekarlsson.com/work/followspot/
---

# FollowSpot

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

2026

[View on GitHub →](https://github.com/JoeKarlsson/followspot) | [Read why I built it](https://www.joekarlsson.com/blog/followspot-local-whisper-teleprompter/)

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

```bash
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:

```markdown
# 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](https://www.joekarlsson.com/images/blog/followspot-local-whisper-teleprompter/column-wide.webp)

Default: wide column

![FollowSpot with a narrow text column centered on screen, three or four words per line](https://www.joekarlsson.com/images/blog/followspot-local-whisper-teleprompter/column-narrow.webp)

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.

_Diagram: How FollowSpot follows you: every quarter second, if your mic isn't quiet, it sends the last 3.5 seconds of audio and the last 30 script words to a local whisper.cpp server, matches the newest words it hears against the script near your place, moves the highlight to the last match and scrolls your line to lens height, backs up only on 4 or more matched words, drifts ahead slowly after 1.5 seconds without a match, and stops when you stop_

[Get the code on GitHub →](https://github.com/JoeKarlsson/followspot) | [Read why I built it](https://www.joekarlsson.com/blog/followspot-local-whisper-teleprompter/)

[← All works](https://www.joekarlsson.com/work/)
