prompter

name	prompter
description	Push and manage Elgato Prompter scripts via Camera Hub with the prompter CLI: doctor, list, push/pull text or Markdown, and restart Camera Hub. Use when loading a teleprompter script, preparing A-roll, or automating Prompter takes.

prompter — Elgato Prompter scripts

CLI for the Camera Hub Prompter library. Prefer this over hand-editing JSON.

Resolve binary

command -v prompter || echo "$HOME/.local/bin/prompter"

Preconditions

1. Elgato Camera Hub installed
2. Prompter hardware connected (for on-device display)
3. For live push: use --restart so Camera Hub reloads the library

Session checklist

- [ ] prompter doctor
- [ ] Write/edit local .md or .txt (repo or /tmp)
- [ ] prompter push FILE --name "Title" --restart
- [ ] On Prompter / Camera Hub UI: select the script if needed
- [ ] Record with sonycam rec + optional screcord

Commands

prompter doctor
prompter list
prompter list --json

prompter push ./script.md --name "My Take" --restart
prompter pull --name "My Take" -o ./out.txt
prompter show --name "My Take"

prompter hub status
prompter hub restart

Hard rules

1. Always --restart for production library writes.
2. Don’t dump full script bodies into chat unless the user asks.
3. Duplicate friendly names require --guid for pull/show.
4. This does not start camera recording — use sonycam rec.

With sonycam + screcord

prompter push ./take.md --name "Take" --restart
sonycam connect && sonycam status
# Terminal A
sonycam liveview
# Terminal B
sonycam rec start
# optional screen:
screcord record --preset tutorial --slug take --display main
sonycam rec stop
sonycam pull --latest --out ~/Movies/sonycam

Failure checklist

Symptom	Fix
doctor WARN running	Expected before push; use --restart
Push ignored after quit	Hub was open during write — push again with --restart
Script missing on device	Select it in Camera Hub Prompter panel
doctor ERROR schema	Camera Hub update changed format — check PrompterKit upstream