Skip to content

aliarain/notchprompt

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

18 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

NotchPrompt πŸŽ™οΈ

NotchPrompt is a professional macOS teleprompter that lives in your Mac's camera notch. It tracks your words in real time, stays invisible during screen shares, and works across Zoom, Teams, Meet, and OBS.

NotchPrompt Banner


Why NotchPrompt

Most teleprompters are either hardware rigs or clunky apps that show up in screen recordings. NotchPrompt is different:

  • True eye contact β€” text sits right next to your camera, not below it
  • Screen-share invisible β€” uses sharingType = .none so it never appears in Zoom, Teams, Meet, or OBS recordings
  • Word-level tracking β€” highlights each word as you say it, in real time, using on-device speech recognition
  • No subscription β€” fully local, no cloud, no account required

Features

Overlay Modes

Mode Description
Notch Anchored below the Mac notch. Expands with a Dynamic Island animation.
Floating Draggable window you can place anywhere on screen. Always on top.
Fullscreen Takes over an entire display. Perfect for a dedicated teleprompter monitor.

Listening Modes

Mode Description
Word Tracking Highlights each word as you say it. Fuzzy matching handles accents and STT errors.
Voice-Activated Scrolls while you speak, pauses when you go silent.
Classic Auto-scrolls at a constant WPM. No microphone needed.

Script Management

  • Multi-page scripts β€” split long scripts into pages, navigate between them in the sidebar
  • PPTX import β€” drag a PowerPoint file to import presenter notes as pages
  • File save/open β€” export and import .notchprompt files
  • Script templates β€” Sales Pitch, Presentation, Interview, Blank
  • Dictation mode β€” dictate text directly into the editor with your voice
  • Word count, char count, estimated read time per page

Overlay Controls

  • Tap-to-jump β€” tap any word to jump the reading position there
  • Resizable height β€” drag the handle to make the overlay taller on the fly
  • In-overlay page picker β€” tap the page indicator to jump to any page
  • Auto next page β€” configurable countdown (1–10s) auto-advances pages
  • Hover-to-pause β€” move your mouse over the overlay to pause scrolling
  • Scroll wheel β€” use trackpad or mouse wheel to scroll manually
  • Last spoken words β€” shows the last few words you said next to the waveform
  • Audio waveform + progress β€” live waveform with reading progress coloring
  • Elapsed time β€” MM:SS timer showing how long you've been reading

Appearance

  • Font families β€” Sans, Serif, Mono, Dyslexia (OpenDyslexic)
  • Font sizes β€” XS (14pt), SM (16pt), LG (20pt), XL (24pt)
  • Text colors β€” White, Yellow, Cyan, Green, Lavender
  • Cue color + brightness β€” separate color and opacity for [bracket] annotations
  • Blur background β€” frosted glass effect with adjustable opacity
  • Background opacity β€” adjust the overlay darkness

System Integration

  • macOS Services β€” right-click any text β†’ "Read in NotchPrompt"
  • URL scheme β€” notchprompt://read?text=Your+script from any app or script
  • Multi-display β€” overlay follows your mouse to whichever screen it's on
  • Auto-update checker β€” silent check on launch, prompt when update available
  • Read pages tracking β€” green badge on pages already read this session

Speech Settings

  • 9 languages β€” English (US/UK), Spanish, French, German, Italian, Portuguese, Japanese, Chinese
  • Microphone selection β€” choose any CoreAudio input device
  • Keynote import warning β€” helpful instructions when you drop a .key file

Keyboard Shortcuts

Overlay Controls

Shortcut Action
↑ / ↓ Scroll up / down
Space Play / Pause (Classic mode)
Esc Close overlay

Global Hotkeys (requires Accessibility permission)

Shortcut Action
`βŒƒ + `` Toggle overlay on/off
βŒƒ + Space Start / Stop scrolling
β‡§βŒ˜O Toggle overlay
β‡§βŒ˜S Start / Stop scroll
β‡§βŒ˜R Reset position
β‡§βŒ˜] Next script
β‡§βŒ˜[ Previous script

Installation

Manual

  1. Download the latest .dmg from Releases.
  2. Drag NotchPrompt to your Applications folder.
  3. Launch it β€” the icon appears in your menu bar.

Homebrew

brew install --cask notchprompt

Permissions

NotchPrompt needs two permissions for voice features:

  • Microphone β€” for speech recognition in Word Tracking and Voice-Activated modes
  • Speech Recognition β€” for on-device word matching

Both are requested on first use. Grant them in System Settings β†’ Privacy & Security.

Classic mode works with no permissions at all.


Development

Requirements

  • macOS 14.0+
  • Xcode 15.0+

Build

git clone https://github.com/aliarain/notchprompt.git
cd notchprompt
xcodebuild -project NotchPrompt.xcodeproj -scheme NotchPrompt build

Project Structure

NotchPrompt/
β”œβ”€β”€ App/
β”‚   β”œβ”€β”€ NotchPromptApp.swift       # @main entry point
β”‚   └── AppDelegate.swift          # Menu bar, overlay management, hotkeys
β”œβ”€β”€ Views/
β”‚   β”œβ”€β”€ OverlayPanelController.swift  # Notch / Floating / Fullscreen routing
β”‚   β”œβ”€β”€ OverlayContentView.swift      # Main teleprompter UI
β”‚   β”œβ”€β”€ WordFlowView.swift            # Word-level highlight layout engine
β”‚   β”œβ”€β”€ ScriptEditorView.swift        # Script editor with multi-page support
β”‚   └── SettingsView.swift            # 6-tab settings panel
β”œβ”€β”€ Core/
β”‚   β”œβ”€β”€ ScrollingController.swift     # All scroll modes + settings state
β”‚   β”œβ”€β”€ SpeechRecognitionManager.swift # Word tracking + fuzzy matching
β”‚   └── DictationManager.swift        # Editor dictation
β”œβ”€β”€ Models/
β”‚   └── Script.swift                  # Script model + CJK word splitting
β”œβ”€β”€ Services/
β”‚   β”œβ”€β”€ ScriptStorage.swift           # Persistence + PPTX import
β”‚   └── UpdateChecker.swift           # GitHub releases checker
└── Helpers/
    └── Theme.swift                   # Colors, animations, button styles

Contributing

Contributions are welcome. See CONTRIBUTING.md for guidelines.


Credits

Built by:

  • RaptrX β€” digital product studio
  • Ali Arain β€” developer & founder

License

MIT License. See LICENSE for details.

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages