Help

How to use Bema, and what to do when something doesn't work.

Getting started

  1. Install. Download Bema, open the DMG and drag Bema to Applications. It runs on macOS 14 or later with PowerPoint or Keynote.
  2. Open a deck. Press ⌃⌥P while it's open in PowerPoint or Keynote, click Present with Bema on PowerPoint's Home tab, right-click a .pptx or .key in Finder and choose Open With → Bema, or use File → Open ⌘O. Decks opened from OneDrive, SharePoint or Teams work too: open them in PowerPoint first, then press ⌃⌥P.
  3. Allow what it asks for. Control of PowerPoint or Keynote (so it can run the show), and Accessibility (so the slides go full screen on the audience display). The microphone and camera are asked for only when you use them.
  4. Press Start slideshow ⌘↩. With more than one display, Bema asks where the slides should go: the usual display is already picked, so press Return, or click another one.

Bema lives in the menu bar (the b with the amber line) and keeps running when you close its window. Open at login is in that menu.

Presenting

PowerPoint or Keynote plays the slides on the audience display; Bema shows you the current and next slide, your notes, a filmstrip and a timer.

  • Move: → Space Page Down next, ← Page Up back. Clickers work. Click a thumbnail to jump.
  • Black or white screen: B or W.
  • Timer: click "of 20:00" to set your planned length. Bema then says if you're on pace, behind or ahead.
  • End the show: Esc or End show.
  • Screen sharing on a call: Bema's window is hidden from screen sharing by default, so people see your slides, not your notes. Change it in Stage tools.

Voice prompter

Open the Prompter tab next to Notes and press Start. Your notes become one script that scrolls as you speak.

  • Voice follows what you say, Auto scrolls at a set speed, Manual moves when you scroll, drag or click a word. Clicking a word or scrolling works in every mode.
  • Follow moves the slideshow along with the script. Line sets where the reading line sits: higher shows more of what's coming.
  • Detach opens the prompter in its own window that floats under your camera and stays out of screen shares.
  • Write **bold** or cues like [pause] in your PowerPoint notes to see them highlighted.

Your camera

  • Self view (top bar, ⌥⌘V): a small mirror of your camera that only you see. It floats above everything and stays out of screen sharing. Drag it anywhere, or hover and choose move under the camera. Closing it turns the camera off.
  • Light (the sun, in the top bar while the camera is on, and in the self view): opens macOS's Video Effects menu, where you turn Edge Light (the glow around the screen), Portrait or Studio Light on or off for Bema.
  • On slides (top bar): your camera in a round bubble on the slides the audience sees, during the show. Choose the corner and size in Stage tools.

Pointer, coach and stage tools

  • Pointer: L laser, S spotlight, M magnifier, P pen, H highlighter, T stamps; E clears. Point or draw on the slide in Bema and it shows on the audience screen. 1 2 3 fire confetti, applause or hearts.
  • Stage tools (top right, or ⇧⌘T): phone remote, live poll, captions, voice commands, speech coach, rehearsal mode.
  • Rehearsal mode shows a report when the show ends: time per slide, speaking speed and filler words.

Writing speaker notes

On a slide with no notes, click Write notes (or All slides without notes). What's written is a draft: Bema shows it and the prompter follows it, but it goes into your deck only when you click Save to deck, which writes it into PowerPoint's or Keynote's speaker notes and saves. Notes already in the deck are never replaced. Choose who writes in View → Notes Writer Settings…:

  • On this Mac with Apple Intelligence: free, and nothing leaves your Mac.
  • A local model in Ollama or LM Studio.
  • Your Claude or OpenAI API key: the slide's text and picture are sent to that company only when you ask.
  • The Claude app, with your subscription: click Connect Claude Desktop, reopen Claude, then ask it to write notes for your Bema deck (Bema's button copies the request for you). ChatGPT can't connect to apps on your Mac.

Phone remote and polls

In Stage tools, turn on the phone remote and scan the QR code with your phone's camera, or show a poll for the audience to scan. Phones must be on the same Wi-Fi as your Mac. Each link carries a secret code, so only people who scan it can use it.

The PowerPoint button

  1. In Bema's menu bar menu, choose Add the Bema button to PowerPoint… (or File → Add Bema Button to PowerPoint…). If macOS asks whether Bema may access PowerPoint's data, allow it.
  2. Quit PowerPoint with ⌘Q and open it again.
  3. Find Present with Bema at the right end of the Home tab.

Troubleshooting

The slides have a title bar instead of going full screen

Bema needs Accessibility. Open System Settings → Privacy & Security → Accessibility and turn Bema on. If Bema is already listed but it still happens (for example after an update), select it, remove it with –, and allow it again.

The PowerPoint button doesn't appear

  • Quit PowerPoint completely (⌘Q) and reopen it; PowerPoint only loads add-ins when it starts.
  • Check Insert → Add-ins → My Add-ins for Bema under Developer Add-ins, and click it once.
  • In Finder, Go → Go to Folder… ~/Library/Containers/com.microsoft.Powerpoint/Data/Documents/wef should hold bema-powerpoint-button.xml. If the folder is missing, add the button again from Bema and allow access when macOS asks.
  • A work Microsoft 365 account may have add-ins turned off by your IT team. ⌃⌥P still works.

The prompter doesn't follow my voice

  • Make sure the mic level bars move while you speak. If they don't, allow Bema in System Settings → Privacy & Security → Microphone and Speech Recognition.
  • Choose the language you're speaking in the prompter's language menu.
  • Lost? Click the word you're on, or scroll to it: following carries on from there.

Is my self view or prompter visible in a screen share?

No: both windows are excluded from screen sharing, recordings and screenshots. Do a quick test share in your call app before an important talk.

My phone can't open the remote

The phone and the Mac need to be on the same Wi-Fi. Guest and some office networks block devices from reaching each other; use a personal hotspot or another network. If macOS asks whether Bema may accept incoming connections, choose Allow.

Bema asks for permissions again

macOS remembers permissions per app. After moving Bema or installing a new copy, it may ask once more. That's expected.

Updates

Bema checks for updates once a day and installs only updates signed by Bema. Use Bema → Check for Updates… to check now.

Still stuck?

Report a problem on GitHub. Please describe what happened, or recreate it with the sample deck, rather than attaching your real decks or notes. A privacy or security problem? Use the private form described in SECURITY.md.