Skip to content

Permissions

Enable microphone access, macOS Accessibility, and Windows or Linux desktop integration for recording and pasting with Yap.

macOS

Install Yap in Applications before granting permissions, so the permission entry points to the copy you intend to run.

Microphone

Allow the microphone request during setup. If denied, open System Settings → Privacy & Security → Microphone and enable Yap. If Yap is absent, start its setup or try recording to trigger the request.

Accessibility

Open System Settings → Privacy & Security → Accessibility, add /Applications/Yap.app if needed, and enable it. This supports global key detection and simulated pasting.

After replacing or moving the app, an old permission entry may stop working. Quit Yap, remove the old entry, add the installed copy again, and reopen it. Yap 0.5.0 includes an Accessibility recovery screen with a check-again action and a layout that fits shorter windows.

Windows

In Windows 11, open Settings → Privacy & security → Microphone. In Windows 10, use Settings → Privacy → Microphone. Enable microphone access and Let desktop apps access your microphone. Yap is a desktop app, so it may not have an individual per-app toggle.

Test recording from Yap first, then try your global hotkey. If auto-paste fails in an elevated application, test in a normal editor with the same privilege level as Yap. You can copy from History and paste manually.

Linux

Check the selected input and mute state in your desktop’s sound settings or PulseAudio/PipeWire controls. Yap captures audio through PortAudio.

Global hotkeys use X11 and auto-paste invokes xdotool. Clipboard support needs xclip or xsel. Native Wayland integration is not implemented; use an X11 session or the in-app recording controls and a clipboard workflow supported by your desktop.

Verify the setup

  1. Select the intended microphone in Yap Settings.
  2. Record a short sentence from Home.
  3. Repeat using the recording key while a plain-text editor is focused.
  4. If recording works but pasting does not, copy from History and use Cmd+V on macOS or Ctrl+V on Windows/Linux.

See troubleshooting for runtime and platform-specific failures.