A native macOS teleprompter that runs as a floating overlay completely invisible to Zoom, Teams, Google Meet, OBS, and every other screen-sharing tool.
-
Screen-capture invisible —
NSWindow.sharingType = .nonekeeps the overlay off every shared screen -
Menu-bar only — no Dock icon, no Cmd+Tab entry; lives quietly in the menu bar
-
Rich Markdown rendering — headings scale visually (H1 = 1.6×, H2 = 1.35×…), bold and italic rendered inline
-
Smooth auto-scroll — 60 Hz, time-delta based (constant speed regardless of frame drops)
-
Manual scroll — trackpad or mouse wheel with per-device sensitivity
-
On-window controls — hover to reveal: play/pause, reset, speed slider, font ±, close
-
Resizable — drag the bottom-right corner handle to any size
-
Draggable — click and drag anywhere on the background to reposition
-
Keyboard shortcuts (click the overlay to focus it first):
Key Action SpacePlay / Pause RReset to top EscPause +Increase font size −Decrease font size -
Persistent settings — font size, colour, opacity, scroll speed, window position and size survive restarts
-
No dependencies — zero third-party packages; pure Swift + AppKit + SwiftUI
| macOS | 14.0 Sonoma or later |
| Xcode | 15.0+ (for Xcode builds) |
| Swift | 5.9+ (included with Xcode 15 or Command Line Tools) |
git clone https://github.com/pedrambayat/teleprompter.git
cd teleprompter
./build.sh
open Teleprompter.appThe script compiles a release binary, assembles a .app bundle, and ad-hoc signs it.
brew install xcodegen
xcodegen generate
open Teleprompter.xcodeprojThen build and run with Cmd+R.
- Xcode → File → New → Project → macOS → App
- Name:
Teleprompter, Interface: SwiftUI, Language: Swift - Deployment target: macOS 14.0
- Replace the generated Swift files with everything in
Sources/Teleprompter/ - Copy
AppResources/Info.plistentries into the target's Info tab - Set
AppResources/Teleprompter.entitlementsas the entitlements file - Build & Run
- Click the menu bar icon (document + magnifier) to open the settings panel.
- Open a script file —
.txtor.mdformats supported. The overlay appears automatically. - Drag the overlay to position it on screen (click anywhere on the background).
- Resize by dragging the bottom-right corner handle.
- Hover over the overlay to reveal controls:
- Top strip: × (close), A− / A+ (font size)
- Bottom strip: ⏮ (reset), ▶/⏸ (play/pause), speed slider
- Click the overlay to give it keyboard focus, then use
Space/R/Esc/+/−. - Right-click the menu bar icon to quit the app.
| Syntax | Renders as |
|---|---|
# Heading 1 |
Large bold text (1.6× font size) |
## Heading 2 |
Bold text (1.35×) |
### Heading 3 |
Bold text (1.15×) |
**bold** |
Bold |
*italic* |
Italic |
--- |
Horizontal rule separator |
teleprompter/
├── Package.swift # Swift Package Manager manifest
├── build.sh # Build + bundle + sign script
├── project.yml # XcodeGen spec
├── AppResources/
│ ├── Info.plist # LSUIElement = YES
│ └── Teleprompter.entitlements # App Sandbox, user-selected files
└── Sources/Teleprompter/
├── TeleprompterApp.swift # @main — SwiftUI App entry point
├── AppDelegate.swift # Menu bar item, popover, window setup
├── TeleprompterWindow.swift # NSWindow subclass — sharingType = .none
├── TeleprompterWindowController.swift # Window lifecycle, keyboard, resize
├── TeleprompterViewModel.swift # @Observable source of truth
├── TeleprompterSettings.swift # Codable UserDefaults persistence
├── ScrollEngine.swift # 60 Hz timer-based auto-scroll
├── FileLoader.swift # Security-scoped .txt / .md reading
├── ResizeHandle.swift # Drag-to-resize corner NSViewRepresentable
├── TeleprompterView.swift # Overlay: text + chrome + controls
├── ControlStripView.swift # Play/pause/speed — shown on hover
└── SettingsPanelView.swift # Popover: file, appearance, speed
- Start a Zoom screen share (share your full screen).
- Look at Zoom's green "sharing" preview — the teleprompter window is absent.
- Ask a meeting participant to confirm — they cannot see it.
The same is true for Teams, Google Meet, OBS Studio, QuickTime screen recording, and screencapture CLI.
Pull requests are welcome!
- Fork the repo
- Create a feature branch (
git checkout -b feature/my-feature) - Commit your changes
- Open a pull request
MIT — see LICENSE.