From 42c210faaf4deda42a7c02472ef23ba08a8749d0 Mon Sep 17 00:00:00 2001 From: mao13811364454 <293340454+mao13811364454@users.noreply.github.com> Date: Wed, 30 Sep 2026 09:30:50 +0800 Subject: [PATCH] fix(macos): allow terminal tools to request audio input Add the audio-input entitlement and microphone usage description for recording tools launched from the integrated terminal. Document user consent, virtual-input routing, and short-recording verification. --- src-tauri/Info.plist | 2 ++ src-tauri/sidecar-entitlements.plist | 3 +++ website/guide/terminal.md | 15 +++++++++++++++ 3 files changed, 20 insertions(+) diff --git a/src-tauri/Info.plist b/src-tauri/Info.plist index a2352ce8a..323b8f45e 100644 --- a/src-tauri/Info.plist +++ b/src-tauri/Info.plist @@ -18,6 +18,8 @@ entirely and falls back to the .icns. --> + NSMicrophoneUsageDescription + Allow command-line tools you run in VMark's integrated terminal to record audio from your microphone or other audio input devices. CFBundleVersion CFBundleIconName diff --git a/src-tauri/sidecar-entitlements.plist b/src-tauri/sidecar-entitlements.plist index d7445c344..769590be4 100644 --- a/src-tauri/sidecar-entitlements.plist +++ b/src-tauri/sidecar-entitlements.plist @@ -2,6 +2,9 @@ + + com.apple.security.device.audio-input + com.apple.security.cs.allow-jit diff --git a/website/guide/terminal.md b/website/guide/terminal.md index 74e2ef28a..cd5de251b 100644 --- a/website/guide/terminal.md +++ b/website/guide/terminal.md @@ -186,6 +186,21 @@ Standard shell shortcuts like `Ctrl+R` (reverse history search in zsh/bash) work When the workspace root changes after the terminal is already running, idle sessions automatically `cd` to the new root. A session busy with a command (say, `vim` or `less`) is not interrupted: it changes directory once the command finishes, which needs [shell integration](#shell-integration) to detect. With the [workspace rail](/guide/workspace-rail) on, sessions that belong to a workspace keep their own directory. +## Audio input on macOS + +Recording tools running in the integrated terminal may request microphone +permission under VMark's name. Allow access when macOS asks. If VMark is listed in +**System Settings → Privacy & Security → Microphone**, you can manage its access +there. If no prompt or entry appears, collect the recording tool's output and +macOS permission logs when reporting the issue. Permission is requested when a +tool accesses audio input, not simply when you open the terminal. + +For virtual audio inputs such as BlackHole, permission alone does not establish +audio routing. Select the intended input in your recording tool, route audio to it, and verify +a short recording before a longer session. A growing audio file alone does not +confirm that sound was captured. VMark does not include a recorder or transcriber; +those commands are provided by tools you install separately. + ## Not yet implemented These are tracked but do **not** ship today. They are listed here because