Getting Started
Your first Promptr demo in 10 minutes
A step-by-step walkthrough from install to presenting your first mapped demo.
Promptr has two components — both are required
What you'll do
- 1. Install the Chrome extension
- 2. Download and install the Mac app
- 3. Launch the app and grant Accessibility permission
- 4. Find Promptr in your menu bar
- 5. Grant site access in the extension
- 6. Add your first content file
- 7. Turn on Learning Mode and map content
- 8. Open the teleprompter
- 9. Present your first demo
Install the Chrome extension
Promptr uses a companion Chrome extension to detect what you're presenting in your browser. Install it from the Chrome Web Store.
Add to ChromeAfter installing, pin the extension to your toolbar so you can access it easily:
- Click the puzzle piece icon in Chrome's toolbar
- Find "Promptr — Context-Aware Teleprompter" in the list
- Click the pin icon to keep it visible in the toolbar

Screenshot placeholder — pin-extension.png
Download the Mac app
Promptr is a native macOS app. Download the latest release, unzip it, and drag Promptr.app to your Applications folder.
Launch the app
Open your Applications folder and double-click Promptr.app. The first time you run it, macOS will prompt you to grant Accessibility permission — this is needed to track which app is in the foreground.

Screenshot placeholder — accessibility-prompt.png
Privacy note
Find Promptr in your menu bar
Promptr lives in your menu bar — there's no dock icon and no app window until you open the teleprompter. Look for the blue Promptr icon near the clock at the top-right of your screen.

Screenshot placeholder — menu-bar-icon.png
Click the icon to open the Promptr menu. You'll see options for the teleprompter, Learning Mode, Shared Folders, and more.

Screenshot placeholder — menu-bar-menu.png
Grant site access
On install, the Promptr extension has access to zero websites. You explicitly grant access to only the sites you want to demo on.
Navigate to a site you'll use for a demo — your own product, Salesforce, Google Slides, whatever. Then click the Promptr extension icon in your toolbar.

Screenshot placeholder — extension-popup.png
Click "Grant access to [site]". Chrome will show its native permission prompt — click Allow. The page reloads automatically and Promptr is now active on that site.
Revoke anytime
Add your first content
Promptr reads content from a folder in your Documents directory. Open the menu bar and click "Open Content Library" — this opens ~/Documents/PromptrLibrary/ in Finder.

Screenshot placeholder — content-library.png
Create a new Markdown file (or use TextEdit to create an RTF) with your talking points for a specific screen in your demo. For example:
# Dashboard Overview Key points to hit when showing the dashboard: - **Real-time metrics** — everything updates live - **Customizable** — drag and drop widgets - **Role-based** — admins see everything ## Common questions - "How far back does data go?" — 13 months by default
Map content to your demo with Learning Mode
Now teach Promptr where to show your content.
Click the Promptr menu bar icon and toggle Learning Mode (or press ⌘⇧L).

Screenshot placeholder — learning-mode-banner.png
Navigate your demo in Chrome. You'll see blue outlines as you hover over elements. Click any element to record it as an anchor — the outline turns green with a checkmark.
You can also click "Map This Page" in the banner to record the entire page as one anchor.
When you're done mapping, toggle Learning Mode off from the menu bar. Then click "Manage Mappings..." (or ⌘⇧M) to assign content files to each anchor you recorded.

Screenshot placeholder — manage-mappings.png
Open the teleprompter
Click "Show Promptr" in the menu bar (or press ⌘⇧T) to open the teleprompter window. It's an always-on-top overlay that stays visible over other apps.

Screenshot placeholder — teleprompter-window.png
Hover over the bottom of the teleprompter to reveal the control panel — you can adjust text size, scroll speed, and opacity. All settings persist across sessions.
Transparency is your friend
Present your demo
You're ready. Make sure Learning Mode is off, then navigate your demo normally in Chrome.
As you move between pages and click elements, Promptr detects your context and pushes the right content to the teleprompter automatically. No fumbling, no window switching.
Keyboard shortcuts during a demo:
- Space — Pause/resume scrolling
- ↑ / ↓ — Adjust scroll speed
- Esc — Dismiss current content
You're all set!
Need help?
Check the FAQ or email us at contact@mc375.com