Skip to main content

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. 1. Install the Chrome extension
  2. 2. Download and install the Mac app
  3. 3. Launch the app and grant Accessibility permission
  4. 4. Find Promptr in your menu bar
  5. 5. Grant site access in the extension
  6. 6. Add your first content file
  7. 7. Turn on Learning Mode and map content
  8. 8. Open the teleprompter
  9. 9. Present your first demo
1

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 Chrome

After installing, pin the extension to your toolbar so you can access it easily:

  1. Click the puzzle piece icon in Chrome's toolbar
  2. Find "Promptr — Context-Aware Teleprompter" in the list
  3. Click the pin icon to keep it visible in the toolbar
Pinning the Promptr Chrome extension

Screenshot placeholder — pin-extension.png

Pin Promptr so you can grant site access with one click
2

Download the Mac app

Promptr is a native macOS app. Download the latest release, unzip it, and drag Promptr.app to your Applications folder.

Download for Mac
Requires macOS 14 (Sonoma) or later. Universal binary — runs on both Apple Silicon and Intel. Signed and notarized by Apple.
3

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.

macOS Accessibility permission prompt

Screenshot placeholder — accessibility-prompt.png

Grant Accessibility access from System Settings > Privacy & Security > Accessibility

Privacy note

Accessibility access only tells Promptr which app is active — it does not read any content. All content matching happens locally.
4

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.

Promptr icon in the macOS menu bar

Screenshot placeholder — menu-bar-icon.png

Click the Promptr icon in the menu bar to access all features

Click the icon to open the Promptr menu. You'll see options for the teleprompter, Learning Mode, Shared Folders, and more.

Promptr menu bar dropdown

Screenshot placeholder — menu-bar-menu.png

The full Promptr menu with all controls
The Chrome extension automatically connects to the Mac app. Both should now be running — you can install them in either order.
5

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.

Promptr extension popup showing site access controls

Screenshot placeholder — extension-popup.png

The extension popup shows the current site and any previously granted sites

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

The same popup shows a list of all sites with access. Click Remove next to any site to revoke access immediately.
6

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.

The PromptrLibrary folder in Finder

Screenshot placeholder — content-library.png

Drop your talking point files here — Markdown, RTF, RTFD, or plain text

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
You can organize files in subfolders for bigger libraries. Shared folders (iCloud, Google Drive, Dropbox) can also be added from Promptr → Shared Folders...
7

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).

Learning mode banner in Chrome

Screenshot placeholder — learning-mode-banner.png

You'll see a blue "PROMPTR LEARNING MODE" banner at the top of the page

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.

The Manage Mappings window

Screenshot placeholder — manage-mappings.png

Each URL pattern is a collapsible group with its recorded anchors
8

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.

The Promptr teleprompter window

Screenshot placeholder — teleprompter-window.png

The teleprompter window shows your mapped content with adjustable controls

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

Drag the opacity slider down to about 70-80% so you can overlay the teleprompter on top of your demo. You see your talking points, your audience sees your app.
9

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!

Promptr is now ready for your next demo. The more you use Learning Mode, the more your talking points will follow you automatically.

Need help?

Check the FAQ or email us at contact@mc375.com