feat: extend deeplinks for recording control + Raycast extension

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

@@ -15,17 +15,47 @@ pub enum CaptureMode {
     Window(String),
 }
 
+impl CaptureMode {
+    /// Resolve a CaptureMode into a ScreenCaptureTarget, or default to the primary display.
+    fn resolve(mode: Option<Self>) -> Result<ScreenCaptureTarget, String> {
+        match mode {
+            Some(CaptureMode::Screen(name)) => cap_recording::screen_capture::list_displays()
+                .into_iter()
+                .find(|(s, _)| s.name == name)
+                .map(|(s, _)| ScreenCaptureTarget::Display { id: s.id })
+                .ok_or(format!("No screen with name \"{}\"", &name)),
+            Some(CaptureMode::Window(name)) => cap_recording::screen_capture::list_windows()
+                .into_iter()
+                .find(|(w, _)| w.name == name)
+                .map(|(w, _)| ScreenCaptureTarget::Window { id: w.id })
+                .ok_or(format!("No window with name \"{}\"", &name)),
+            None => cap_recording::screen_capture::list_displays()
+                .into_iter()
+                .next()
+                .map(|(s, _)| ScreenCaptureTarget::Display { id: s.id })
+                .ok_or_else(|| "No displays available".to_string()),
+        }
+    }
+}
+
 #[derive(Debug, Serialize, Deserialize)]
 #[serde(rename_all = "snake_case")]
 pub enum DeepLinkAction {
     StartRecording {
-        capture_mode: CaptureMode,
+        capture_mode: Option<CaptureMode>,
         camera: Option<DeviceOrModelID>,
         mic_label: Option<String>,
         capture_system_audio: bool,
         mode: RecordingMode,
     },
     StopRecording,
+    PauseRecording,
+    ResumeRecording,
+    TogglePauseRecording,
+    RestartRecording,
+    TakeScreenshot {
+        capture_mode: Option<CaptureMode>,
+    },
     OpenEditor {
         project_path: PathBuf,
     },
@@ -120,18 +150,7 @@ impl DeepLinkAction {
                 crate::set_camera_input(app.clone(), state.clone(), camera, None).await?;
                 crate::set_mic_input(state.clone(), mic_label).await?;
 
-                let capture_target: ScreenCaptureTarget = match capture_mode {
-                    CaptureMode::Screen(name) => cap_recording::screen_capture::list_displays()
-                        .into_iter()
-                        .find(|(s, _)| s.name == name)
-                        .map(|(s, _)| ScreenCaptureTarget::Display { id: s.id })
-                        .ok_or(format!("No screen with name \"{}\"", &name))?,
-                    CaptureMode::Window(name) => cap_recording::screen_capture::list_windows()
-                        .into_iter()
-                        .find(|(w, _)| w.name == name)
-                        .map(|(w, _)| ScreenCaptureTarget::Window { id: w.id })
-                        .ok_or(format!("No window with name \"{}\"", &name))?,
-                };
+                let capture_target = CaptureMode::resolve(capture_mode)?;
 
                 let inputs = StartRecordingInputs {
                     mode,
@@ -147,6 +166,27 @@ impl DeepLinkAction {
             DeepLinkAction::StopRecording => {
                 crate::recording::stop_recording(app.clone(), app.state()).await
             }
+            DeepLinkAction::PauseRecording => {
+                crate::recording::pause_recording(app.clone(), app.state()).await
+            }
+            DeepLinkAction::ResumeRecording => {
+                crate::recording::resume_recording(app.clone(), app.state()).await
+            }
+            DeepLinkAction::TogglePauseRecording => {
+                crate::recording::toggle_pause_recording(app.clone(), app.state()).await
+            }
+            DeepLinkAction::RestartRecording => {
+                crate::recording::restart_recording(app.clone(), app.state())
+                    .await
+                    .map(|_| ())
+            }
+            DeepLinkAction::TakeScreenshot { capture_mode } => {
+                let capture_target = CaptureMode::resolve(capture_mode)?;
+
+                crate::recording::take_screenshot(app.clone(), capture_target)
+                    .await
+                    .map(|_| ())
+            }
             DeepLinkAction::OpenEditor { project_path } => {
                 crate::open_project_from_path(Path::new(&project_path), app.clone())
             }

extensions/raycast/README.md

@@ -0,0 +1,44 @@
+# Cap for Raycast
+
+Control [Cap](https://cap.so) screen recorder directly from Raycast.
+
+## Commands
+
+| Command | Description |
+| --- | --- |
+| Start Recording | Start a new screen recording |
+| Stop Recording | Stop the current recording |
+| Pause Recording | Pause the current recording |
+| Resume Recording | Resume a paused recording |
+| Toggle Pause | Toggle pause/resume |
+| Restart Recording | Restart the current recording |
+| Take Screenshot | Take a screenshot |
+| Open Settings | Open Cap settings |
+
+## How It Works
+
+This extension uses Cap's deeplink protocol (`cap-desktop://action?value=<json>`) to communicate with the desktop app. Make sure Cap is running before using the commands.
+
+## Deeplink Protocol
+
+Cap supports the following deeplink actions:
+
+```
+cap-desktop://action?value="stop_recording"
+cap-desktop://action?value="pause_recording"
+cap-desktop://action?value="resume_recording"
+cap-desktop://action?value="toggle_pause_recording"
+cap-desktop://action?value="restart_recording"
+cap-desktop://action?value={"start_recording":{"capture_mode":{"screen":"Main Display"},"camera":null,"mic_label":null,"capture_system_audio":false,"mode":"studio"}}
+cap-desktop://action?value={"take_screenshot":{"capture_mode":{"screen":"Main Display"}}}
+cap-desktop://action?value={"open_editor":{"project_path":"/path/to/project"}}
+cap-desktop://action?value={"open_settings":{"page":null}}
+```
+
+## Development
+
+```bash
+cd extensions/raycast
+npm install
+npm run dev
+```

extensions/raycast/package.json

@@ -0,0 +1,88 @@
+{
+  "$schema": "https://www.raycast.com/schemas/extension.json",
+  "name": "cap",
+  "title": "Cap",
+  "description": "Control Cap screen recorder — start/stop recording, pause, resume, take screenshots, and more.",
+  "icon": "icon.png",
+  "author": "cap",
+  "categories": ["Productivity", "Applications"],
+  "license": "AGPL-3.0",
+  "commands": [
+    {
+      "name": "start-recording",
+      "title": "Start Recording",
+      "subtitle": "Cap",
+      "description": "Start a new screen recording with Cap",
+      "mode": "no-view"
+    },
+    {
+      "name": "stop-recording",
+      "title": "Stop Recording",
+      "subtitle": "Cap",
+      "description": "Stop the current recording",
+      "mode": "no-view"
+    },
+    {
+      "name": "pause-recording",
+      "title": "Pause Recording",
+      "subtitle": "Cap",
+      "description": "Pause the current recording",
+      "mode": "no-view"
+    },
+    {
+      "name": "resume-recording",
+      "title": "Resume Recording",
+      "subtitle": "Cap",
+      "description": "Resume a paused recording",
+      "mode": "no-view"
+    },
+    {
+      "name": "toggle-pause",
+      "title": "Toggle Pause",
+      "subtitle": "Cap",
+      "description": "Toggle pause/resume on the current recording",
+      "mode": "no-view"
+    },
+    {
+      "name": "restart-recording",
+      "title": "Restart Recording",
+      "subtitle": "Cap",
+      "description": "Restart the current recording",
+      "mode": "no-view"
+    },
+    {
+      "name": "take-screenshot",
+      "title": "Take Screenshot",
+      "subtitle": "Cap",
+      "description": "Take a screenshot with Cap",
+      "mode": "no-view"
+    },
+    {
+      "name": "open-settings",
+      "title": "Open Settings",
+      "subtitle": "Cap",
+      "description": "Open Cap settings",
+      "mode": "no-view"
+    }
+  ],
+  "dependencies": {
+    "@raycast/api": "^1.93.2",
+    "@raycast/utils": "^1.19.1"
+  },
+  "devDependencies": {
+    "@raycast/eslint-config": "^1.0.11",
+    "@types/node": "22.13.14",
+    "@types/react": "19.0.12",
+    "eslint": "^9.23.0",
+    "prettier": "^3.5.3",
+    "typescript": "^5.8.2"
+  },
+  "scripts": {
+    "build": "ray build",
+    "dev": "ray develop",
+    "fix-lint": "ray lint --fix",
+    "lint": "ray lint",
+    "prepublishOnly": "echo \"Error: no publish\" && exit 1",
+    "publish": "npx @raycast/api@latest publish"
+  }
+}

extensions/raycast/src/open-settings.ts

@@ -0,0 +1,8 @@
+import { triggerDeepLink } from "./utils";
+
+export default async function Command() {
+  await triggerDeepLink(
+    { open_settings: { page: null } },
+    "⚙️ Opening Cap settings…",
+  );
+}

extensions/raycast/src/pause-recording.ts

@@ -0,0 +1,5 @@
+import { triggerDeepLink } from "./utils";
+
+export default async function Command() {
+  await triggerDeepLink("pause_recording", "⏸ Pausing Cap recording…");
+}

extensions/raycast/src/restart-recording.ts

@@ -0,0 +1,5 @@
+import { triggerDeepLink } from "./utils";
+
+export default async function Command() {
+  await triggerDeepLink("restart_recording", "🔄 Restarting Cap recording…");
+}

extensions/raycast/src/resume-recording.ts

@@ -0,0 +1,5 @@
+import { triggerDeepLink } from "./utils";
+
+export default async function Command() {
+  await triggerDeepLink("resume_recording", "▶️ Resuming Cap recording…");
+}

extensions/raycast/src/start-recording.ts

@@ -0,0 +1,16 @@
+import { triggerDeepLink } from "./utils";
+
+export default async function Command() {
+  await triggerDeepLink(
+    {
+      start_recording: {
+        capture_mode: null,
+        camera: null,
+        mic_label: null,
+        capture_system_audio: false,
+        mode: "studio",
+      },
+    },
+    "📹 Starting Cap recording…",
+  );
+}

extensions/raycast/src/stop-recording.ts

@@ -0,0 +1,5 @@
+import { triggerDeepLink } from "./utils";
+
+export default async function Command() {
+  await triggerDeepLink("stop_recording", "⏹ Stopping Cap recording…");
+}

extensions/raycast/src/take-screenshot.ts

@@ -0,0 +1,12 @@
+import { triggerDeepLink } from "./utils";
+
+export default async function Command() {
+  await triggerDeepLink(
+    {
+      take_screenshot: {
+        capture_mode: null,
+      },
+    },
+    "📸 Taking screenshot with Cap…",
+  );
+}

extensions/raycast/src/toggle-pause.ts

@@ -0,0 +1,5 @@
+import { triggerDeepLink } from "./utils";
+
+export default async function Command() {
+  await triggerDeepLink("toggle_pause_recording", "⏯ Toggling Cap recording pause…");
+}

extensions/raycast/src/utils.ts

@@ -0,0 +1,35 @@
+import { open, showHUD } from "@raycast/api";
+
+const SCHEME = "cap-desktop";
+
+type DeepLinkAction = string | Record<string, unknown>;
+
+/**
+ * Build a Cap deeplink URL.
+ *
+ * Actions are sent as: cap-desktop://action?value=<json>
+ *
+ * Unit variants (e.g. StopRecording) serialize as a plain string: "stop_recording"
+ * Struct variants serialize as: {"start_recording": {...}}
+ */
+export function buildDeepLink(action: DeepLinkAction): string {
+  const json = JSON.stringify(action);
+  return `${SCHEME}://action?value=${encodeURIComponent(json)}`;
+}
+
+/**
+ * Open a Cap deeplink and show a HUD message.
+ * Shows an error HUD if Cap is not running or the deeplink fails.
+ */
+export async function triggerDeepLink(
+  action: DeepLinkAction,
+  hudMessage: string,
+): Promise<void> {
+  const url = buildDeepLink(action);
+  try {
+    await open(url);
+    await showHUD(hudMessage);
+  } catch {
+    await showHUD("❌ Failed — is Cap running?");
+  }
+}

extensions/raycast/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "display": "Node 22",
+  "compilerOptions": {
+    "lib": ["ES2023"],
+    "module": "Node16",
+    "target": "ES2022",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "moduleResolution": "Node16",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx"
+  },
+  "include": ["src/**/*"]
+}