Skip to content

PureFuncInc/PhemeMurmur

Repository files navigation

PhemeMurmur

macOS menu bar app — press Right Shift to record, transcribe speech via OpenAI or Google Gemini, auto-paste to the active input field and clipboard.

Features

  • Menu bar only — no Dock icon, stays out of your way
  • Right Shift toggle — press to start/stop recording (Esc to cancel)
  • Multi-provider — switch between OpenAI and Google Gemini at runtime
  • Prompt templates — configurable post-processing (translation, formatting, etc.)
  • Auto-paste — transcribed text is written to clipboard and pasted via Cmd+V
  • Zero dependencies — pure Swift, Apple frameworks only

Requirements

  • macOS 13+
  • Xcode Command Line Tools (xcode-select --install) only if building from source
  • API key for OpenAI or Google Gemini

Install

make clean && make install

Share With Coworkers

Build a shareable app bundle zip:

make clean && make dist

This creates:

dist/PhemeMurmur-macOS-<arch>.zip

Your coworker can then:

  1. Unzip PhemeMurmur.app
  2. Move it to /Applications
  3. Launch it

Notes:

  • They do not need Xcode Command Line Tools if you give them the built app
  • The build is architecture-specific (arm64 or x86_64), so build on the same Mac type they use unless you later make a universal app
  • If the app is not signed with an Apple Developer ID and notarized, macOS may warn on first launch; they can usually use Right-click > Open once to allow it

Setup

On first launch, a guided onboarding walks you through:

  1. Grant Accessibility access (System Settings > Privacy & Security > Accessibility)
  2. Set up your API key via the Provider menu in the menu bar
  3. Grant Microphone access (system prompt)

Configuration

The config file is created automatically at:

~/.config/pheme-murmur/config.jsonc

About

Press Right Shift to record, transcribe speech, auto-paste to the active input field and clipboard.

Topics

Resources

Stars

Watchers

Forks

Contributors