Skip to content

ArunNGun/openTeleprompt

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

79 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

OpenTeleprompter

A free, open source voice-activated teleprompter for macOS (Windows v3 coming soon).

Speak β†’ it scrolls. Stop β†’ it pauses. No subscriptions. No cloud. No accounts.


Download β€” v3.0.0

Platform Link Notes
🍎 Apple Silicon (M1–M4) Download .dmg macOS 13+
🍎 Intel Mac Download .dmg macOS 13+
πŸͺŸ Windows (x64) v2.2.1 stable v3 coming soon

Landing page: https://arunngun.github.io/openTeleprompt/


What's New in v3.0

Dynamic Island β€” properly done

The notch overlay now has real concave corners that bite into the menubar bezel exactly like Apple's Dynamic Island. Apple spring physics (cubic-bezier(0.32, 0.72, 0, 1)) for all expand/collapse animations. Looks like part of the OS.

Full React frontend

Entire UI rebuilt in React + Vite with Zustand state management. Faster, cleaner, easier to extend.

Rich text editor

Bold, color highlights, and smart cue markers: [PAUSE] [SLOW] [BREATHE]. Format your script exactly how you want to deliver it.

Script library

Save multiple scripts, switch instantly. Auto-saves on start. Local only β€” no cloud, no account.

Light & dark theme

Pastel light mode default. Toggle from settings or the menubar. Persists across sessions.

Live controls while reading

Adjust scroll speed and font size on the fly β€” no need to pause your delivery.

Redesigned settings panel

Clean React settings view with auto-height. All preferences in one place, persisted across sessions.


Features

  • 🏝️ Dynamic Island mode β€” real concave corners, Apple spring physics, pixel-perfect notch fit
  • πŸ–₯️ Classic mode β€” draggable floating pill, works on any Mac (notch or not)
  • πŸŽ™οΈ Voice-activated scroll β€” frequency analysis (85–3400 Hz), not just volume. Only your voice triggers it
  • πŸ“ Rich text editor β€” bold, highlights, cue markers [PAUSE] [SLOW] [BREATHE]
  • πŸ“š Script library β€” save and switch multiple scripts, auto-saves
  • πŸ”‡ Invisible during screen share β€” Zoom, Meet, Loom can't see it. Only you can
  • πŸŒ— Light & dark theme β€” pastel light default, toggleable
  • ⚑ Live controls β€” speed + font size adjustable while reading
  • 🌫️ Opacity control β€” barely-there to solid
  • ⌨️ Global shortcuts β€” βŒ˜β‡§Space, βŒ˜β‡§β†‘β†“, βŒ˜β‡§R

Version History

v3.0.0 β€” Dynamic Island Redesign (latest)

  • Full React + Vite frontend rewrite
  • Dynamic Island with real concave corners + spring physics
  • Rich text editor (Tiptap), script library, light/dark theme
  • Live speed + font control while reading
  • Playwright visual test suite (16 tests, 48 state combos)
  • macOS only β€” Windows v3 in progress

v2.2.1 β€” Windows Polish

  • Platform-aware tray hint images (Mac + Windows)
  • Author GitHub link in settings

v2.2.0 β€” Windows Support

  • Full Windows support (Classic + Top Bar modes)
  • Native Windows settings panel (Fluent-style)
  • GitHub Actions CI β€” auto-builds Mac + Windows on tag push

v2.0.0 β€” Tauri/Rust Rewrite

v1.x (Electron) v2.x+ (Tauri)
Binary size ~150 MB 4.6 MB
DMG size ~80 MB 2.6 MB
RAM usage ~200 MB ~40 MB

Project Structure

openTeleprompt/
β”œβ”€β”€ src-tauri/          ← Rust backend
β”‚   β”œβ”€β”€ src/lib.rs      ← All Tauri commands
β”‚   └── tauri.conf.json
β”œβ”€β”€ frontend/           ← React + Vite frontend
β”‚   └── src/            ← App.jsx, views, Zustand store
β”œβ”€β”€ index.html          ← Vite entry point
β”œβ”€β”€ settings.html       ← Settings panel entry
β”œβ”€β”€ .github/workflows/  ← CI β€” auto-builds macOS on release tag
β”œβ”€β”€ electron/           ← Legacy Electron v1.x (archived)
└── docs/               ← GitHub Pages landing page

Development

# Install dependencies
npm install

# Dev mode (hot reload)
npm run dev

# Production build β€” macOS
npm run build

# Production build β€” Windows
npm run build:win

Requirements: Rust + Cargo, Node.js 18+


First Launch

macOS

Right-click the app β†’ Open β†’ click Open in the security dialog.

If you see "App is damaged":

xattr -cr /Applications/OpenTeleprompter.app

This strips the macOS quarantine flag. One-time, you won't need it again.

Windows (v2.2.1)

Run the .exe installer. If Windows SmartScreen blocks it, click More info β†’ Run anyway.


Contributing

PRs welcome! See CONTRIBUTING.md.


License

MIT β€” free forever.

About

πŸŽ™οΈ A voice-activated teleprompter that lives in your Mac's notch. Speak and it scrolls. Free & open source.

Topics

Resources

Contributing

Stars

64 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors