Skip to content

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

docs: troubleshoot missing audio devices

AI Agentb43cf7320d30
diff --git a/docs/mintlify/docs-mintlify-mig-tmp/permissions.mdx b/docs/mintlify/docs-mintlify-mig-tmp/permissions.mdx
index 49e96b2d6..0a90b1b32 100644
--- a/docs/mintlify/docs-mintlify-mig-tmp/permissions.mdx
+++ b/docs/mintlify/docs-mintlify-mig-tmp/permissions.mdx
@@ -86,6 +86,18 @@ screen recording is the most failure-prone, but screenpipe also asks for:
the same per-bundle-id rules apply to all of these.
+## audio capture is missing or silent
+
+If screenpipe records the screen but no microphone audio, first verify that the microphone is enabled in **System Settings** → **Privacy & Security** → **Microphone**. External microphones and USB sound cards must also be selected as the input device in the screenpipe recording settings; reconnect the device and restart screenpipe after changing it. If the device is busy or disappears after sleep, quit other apps using the microphone, reconnect the device, and restart screenpipe so audio capture can reopen the stream.
+
+To confirm which devices screenpipe can see, query the local API:
+
+```bash
+curl http://localhost:3030/audio/list
+```
+
+If the expected device is not listed, macOS or the device driver has not exposed it to screenpipe yet. Check that the device works in **System Settings** → **Sound** → **Input**, then relaunch screenpipe. The microphone permission reset below uses the app's bundle ID, just like Screen Recording permission.
+
## still stuck?
send logs from the stuck screen (the **send logs** button uploads them so the team can grep). or book a slot at [cal.com/team/screenpipe/chat](https://cal.com/team/screenpipe/chat).