Getting Started
Installation & Setup
Promptr needs two pieces installed: the macOS app and the Chrome extension. This page is the quick reference — for a screenshot-by-screenshot walkthrough, see the Getting Started guide.
1. Install the macOS app
- Download the latest
.dmgfrom the download button on the site. - Open it and drag Promptr to your Applications folder.
- Launch Promptr. It lives in the menu bar (there’s no dock icon) — look for the Promptr icon at the top-right of your screen.
The app is signed with an Apple Developer ID and notarized, so it opens without security warnings. It requires macOS 14 (Sonoma) or later.
2. Install the Chrome extension
- Install the Promptr extension from the Chrome Web Store.
- Pin it to your toolbar so you can reach its controls quickly.
The background service worker connects to the app at ws://localhost:8765. When the app is running, the extension shows a connected status.
3. Grant access to your demo sites
On install, the extension has access to zero websites. Open a site you present on, click the Promptr extension, and grant access to that site. Promptr only ever sees the pages you explicitly allow.
Only one app instance
8765) for the extension to connect to. If another program is already using that port, the extension won’t connect — see Troubleshooting.4. Confirm it’s working
With the app running and a site granted, open the Promptr menu and choose Show Promptr. You’re ready to start mapping content to your demo.