feat: add recording control deeplinks and Raycast extension by buildingvibes · Pull Request #1587 · CapSoftware/Cap

buildingvibes · 2026-02-09T05:36:05Z

Summary

Extended DeepLinkAction enum with 6 new actions: PauseRecording, ResumeRecording, TogglePauseRecording, SetCamera, SetMicrophone, TakeScreenshot
Created full Raycast extension with 10 commands for controlling Cap from the launcher
Refactored resolve_capture_target into shared helper to reduce duplication

Test plan

Test all new deeplink actions via cap-desktop://action?value=<json>
Verify Raycast extension installs and all commands work
Verify existing deeplink actions still work correctly
/claim Bounty: Deeplinks support + Raycast Extension #1540

…are#1540) Extend the existing deeplink system with new actions for controlling recordings and device switching, then build a Raycast extension that uses those deeplinks for hands-free Cap control. New deeplink actions added to DeepLinkAction enum: - PauseRecording, ResumeRecording, TogglePauseRecording - SetCamera (switch or disable camera during/before recording) - SetMicrophone (switch or disable microphone during/before recording) - TakeScreenshot (capture a screenshot of a specified display/window) Also refactored the capture target resolution into a shared resolve_capture_target helper to reduce duplication. Raycast extension (raycast/) provides commands for: - Start/Stop/Pause/Resume/Toggle-pause recording - Switch microphone (lists system audio input devices) - Switch camera (lists system cameras) - Take screenshot - Open settings

greptile-apps

_{15 files reviewed, 5 comments}

_{Edit Code Review Agent Settings | Greptile}

raycast/src/open-settings.ts

raycast/src/switch-microphone.tsx

raycast/src/switch-camera.tsx

raycast/src/start-recording.ts

raycast/src/take-screenshot.ts

apps/desktop/src-tauri/src/deeplink_actions.rs

raycast/src/switch-microphone.tsx

Remove unused parseMicrophones function and dynamically detect the primary display name instead of hardcoding "Main Display" so the deeplinks work on any machine regardless of display naming.

- Use name.as_str() instead of *name deref in resolve_capture_target - Use ok_or_else for lazy error string allocation - Convert start-recording and take-screenshot to List views that enumerate displays via system_profiler instead of hardcoding - Update package.json command modes to "view" for display selection

raycast/src/switch-camera.tsx

raycast/src/switch-microphone.tsx

raycast/src/start-recording.tsx

raycast/src/switch-camera.tsx

Remove hardcoded "Main Display" fallback in start-recording and take-screenshot parseDisplays, and remove bogus "FaceTime HD Camera" fallback in switch-camera. When system_profiler parsing yields no results, return an empty list instead of guessing names that will fail on the desktop deeplink handler side.

raycast/src/switch-microphone.tsx

raycast/src/utils.ts

apps/desktop/src-tauri/src/deeplink_actions.rs

raycast/package.json

- Tighten DeepLinkAction type to string union for unit actions - Add exact-match hint to error messages in resolve_capture_target - Fix license field to match repo (AGPL-3.0-or-later)

buildingvibes · 2026-02-09T15:08:44Z

Addressed remaining review feedback:

Tightened DeepLinkAction type to use string union for unit actions
Added exact-match hint to error messages in resolve_capture_target
Fixed license field to match repo (AGPL-3.0-or-later)

Working on a demo video to showcase all commands.

buildingvibes · 2026-02-09T17:58:11Z

Demo Video

https://github.com/buildingvibes/Cap/releases/download/demo-videos-cap-pr1587/cap-deeplinks-pr1587.mp4

This demo showcases:

Recording control deeplinks: All new deeplink actions (PauseRecording, ResumeRecording, TogglePauseRecording, SetCamera, SetMicrophone, TakeScreenshot)
Raycast extension: The 10 new Raycast commands for controlling Cap from the launcher
Testing workflow: Shows the integration working end-to-end with real deeplink URLs

The video demonstrates how users can now control Cap recordings through deeplinks, enabling powerful automation and launcher integrations like Raycast.

buildingvibes · 2026-02-12T06:28:24Z

Hi team! Just following up - I've addressed all the review feedback from the automated reviewers (device ID handling, error messages, license field, TypeScript types) and posted a demo video showing the deeplinks and Raycast extension working. Would love to get a maintainer's eyes on this when you have a chance. Happy to make any further adjustments!

greptile-apps bot reviewed Feb 9, 2026

View reviewed changes