Word tracking does not start
Open System Settings → Privacy & Security and allow Textream under both Microphone and Speech Recognition. Quit and reopen Textream after changing permissions.
Quick fixes
The overlay is on the wrong screen
Open Textream Settings → Teleprompter. Choose Follow Mouse to move between displays, or Fixed Display to keep the overlay on one screen.
Remote or Director Mode will not connect
Put both devices on the same trusted network, enable the mode in Settings, and open the address shown by Textream. If prompted, allow incoming connections in the macOS firewall.
PowerPoint notes do not import
Use a .pptx file that contains presenter notes. For Keynote or Google Slides, export to PowerPoint first, then import the exported file.
The overlay appears in a recording
Turn on Hide from Screen Sharing in Teleprompter settings before recording. Then make a short test recording: capture apps and external hardware do not all behave the same way.
Textream will not update
For a Mac App Store installation, update it there. If installed with Homebrew, run brew upgrade textream. Direct downloads are published on GitHub Releases.
What to include
A useful report includes:
- your macOS and Textream versions;
- your Mac model and whether it uses Apple silicon or Intel;
- the guidance and overlay modes you selected;
- steps that reproduce the problem;
- what you expected and what happened instead.
Where to ask
Search existing GitHub issues first. If you do not find a match, open a new issue.
For direct support, email fka@linux.com. The same privacy guidance above applies to anything you send by email.
Textream is a free, open-source project. Support is provided on a best-effort basis; there is no guaranteed response time.
Privacy
Read the Textream Privacy Policy for details about microphone access, Apple speech recognition, saved scripts, and optional local-network features.