Skip to content

PERMISSIONS.md

Latest commit

 

History

History
57 lines (37 loc) · 1.43 KB

PERMISSIONS.md

File metadata and controls

57 lines (37 loc) · 1.43 KB

macOS Permissions Setup

Jot requires Screen Recording and Microphone permissions to capture audio during meetings.

First-Time Setup

When you first launch Jot and try to record:

  1. Click "Open Settings" when prompted
  2. In System Settings > Privacy & Security:
    • Enable Screen Recording for Jot
    • Enable Microphone for Jot
  3. Quit and reopen Jot (permissions take effect after restart)

Why These Permissions?

  • Screen Recording: Required by ScreenCaptureKit to capture system audio (meeting participants' voices)
  • Microphone: Captures your voice during meetings

Troubleshooting

"Failed to start audio capture" error

If you keep seeing permission prompts after enabling them:

# Reset permissions completely
tccutil reset ScreenCapture com.jot.app
tccutil reset Microphone com.jot.app

# Quit Jot
pkill Jot

# Reopen and grant permissions again

Permissions don't persist between builds (developers)

Use the resign script after building:

# Build and auto-resign
pnpm tauri:build

# Or manually resign after building
./resign.sh

This ensures the bundle identifier stays com.jot.app instead of a random hash.

Technical Details

Jot uses macOS 15's ScreenCaptureKit API to capture:

  • System audio (participants speaking in Zoom, Teams, etc.)
  • Microphone audio (your voice)

Both streams are saved as separate WAV files, then transcribed locally using Whisper.