feat: add recording deeplinks and Raycast extension

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

@@ -26,6 +26,15 @@ pub enum DeepLinkAction {
         mode: RecordingMode,
     },
     StopRecording,
+    PauseRecording,
+    ResumeRecording,
+    TogglePauseRecording,
+    SetMicrophone {
+        mic_label: Option<String>,
+    },
+    SetCamera {
+        camera_label: Option<String>,
+    },
     OpenEditor {
         project_path: PathBuf,
     },
@@ -146,6 +155,30 @@ 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::SetMicrophone { mic_label } => {
+                crate::set_mic_input(app.state(), mic_label).await
+            }
+            DeepLinkAction::SetCamera { camera_label } => {
+                let camera = match camera_label {
+                    Some(label) => crate::recording::list_cameras()
+                        .into_iter()
+                        .find(|camera| camera.display_name() == label)
+                        .map(|camera| DeviceOrModelID::from_info(&camera))
+                        .ok_or(format!("No camera with label \"{}\"", &label))?,
+                    None => return crate::set_camera_input(app.clone(), app.state(), None, None).await,
+                };
+
+                crate::set_camera_input(app.clone(), app.state(), Some(camera), None).await
+            }
             DeepLinkAction::OpenEditor { project_path } => {
                 crate::open_project_from_path(Path::new(&project_path), app.clone())
             }

apps/raycast/README.md

@@ -0,0 +1,17 @@
+# Cap Raycast Extension
+
+This extension controls Cap Desktop through the `cap-desktop://action` deeplink.
+
+## Commands
+
+- Start Recording
+- Stop Recording
+- Pause Recording
+- Resume Recording
+- Toggle Pause Recording
+- Switch Microphone
+- Switch Camera
+
+All commands serialize a `DeepLinkAction` payload and open:
+
+`cap-desktop://action?value=<json>`

apps/raycast/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@cap/raycast",
+  "private": true,
+  "version": "0.0.1",
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@raycast/api": "^1.83.1"
+  },
+  "devDependencies": {
+    "@raycast/eslint-config": "^2.0.9",
+    "@types/node": "^22.13.10",
+    "@types/react": "^19.2.14",
+    "react": "^19.2.4",
+    "typescript": "^5.8.3"
+  },
+  "raycast": {
+    "schemaVersion": 1,
+    "title": "Cap",
+    "description": "Control Cap recording through deeplinks",
+    "author": "capsoftware",
+    "commands": [
+      {
+        "name": "start-recording",
+        "title": "Start Recording",
+        "description": "Start a Cap recording",
+        "mode": "view"
+      },
+      {
+        "name": "stop-recording",
+        "title": "Stop Recording",
+        "description": "Stop the current Cap recording",
+        "mode": "no-view"
+      },
+      {
+        "name": "pause-recording",
+        "title": "Pause Recording",
+        "description": "Pause the current Cap recording",
+        "mode": "no-view"
+      },
+      {
+        "name": "resume-recording",
+        "title": "Resume Recording",
+        "description": "Resume a paused Cap recording",
+        "mode": "no-view"
+      },
+      {
+        "name": "toggle-pause-recording",
+        "title": "Toggle Pause Recording",
+        "description": "Toggle pause/resume for the current recording",
+        "mode": "no-view"
+      },
+      {
+        "name": "switch-microphone",
+        "title": "Switch Microphone",
+        "description": "Switch microphone by label",
+        "mode": "view"
+      },
+      {
+        "name": "switch-camera",
+        "title": "Switch Camera",
+        "description": "Switch camera by label",
+        "mode": "view"
+      }
+    ]
+  }
+}

apps/raycast/src/pause-recording.ts

@@ -0,0 +1,5 @@
+import { dispatchSimpleAction } from "./utils";
+
+export default async function Command() {
+  await dispatchSimpleAction("pause_recording");
+}

apps/raycast/src/resume-recording.ts

@@ -0,0 +1,5 @@
+import { dispatchSimpleAction } from "./utils";
+
+export default async function Command() {
+  await dispatchSimpleAction("resume_recording");
+}

apps/raycast/src/start-recording.tsx

@@ -0,0 +1,58 @@
+import { Action, ActionPanel, Form } from "@raycast/api";
+import { dispatchAction } from "./utils";
+
+type Values = {
+  targetType: "screen" | "window";
+  targetName: string;
+  mode: "studio" | "instant";
+  micLabel: string;
+  cameraLabel: string;
+  captureSystemAudio: boolean;
+};
+
+export default function Command() {
+  return (
+    <Form
+      actions={
+        <ActionPanel>
+          <Action.SubmitForm
+            title="Start Recording"
+            onSubmit={async (values: Values) => {
+              const captureMode =
+                values.targetType === "window"
+                  ? { window: values.targetName }
+                  : { screen: values.targetName };
+
+              await dispatchAction({
+                start_recording: {
+                  capture_mode: captureMode,
+                  camera: null,
+                  mic_label: values.micLabel || null,
+                  capture_system_audio: values.captureSystemAudio,
+                  mode: values.mode,
+                },
+              });
+
+              if (values.cameraLabel) {
+                await dispatchAction({ set_camera: { camera_label: values.cameraLabel } });
+              }
+            }}
+          />
+        </ActionPanel>
+      }
+    >
+      <Form.Dropdown id="targetType" title="Target Type" defaultValue="screen">
+        <Form.Dropdown.Item value="screen" title="Screen" />
+        <Form.Dropdown.Item value="window" title="Window" />
+      </Form.Dropdown>
+      <Form.TextField id="targetName" title="Target Name" placeholder="Built-in Retina Display" />
+      <Form.Dropdown id="mode" title="Mode" defaultValue="studio">
+        <Form.Dropdown.Item value="studio" title="Studio" />
+        <Form.Dropdown.Item value="instant" title="Instant" />
+      </Form.Dropdown>
+      <Form.TextField id="micLabel" title="Microphone Label" placeholder="Optional" />
+      <Form.TextField id="cameraLabel" title="Camera Label" placeholder="Optional" />
+      <Form.Checkbox id="captureSystemAudio" label="Capture System Audio" defaultValue={true} />
+    </Form>
+  );
+}

apps/raycast/src/stop-recording.ts

@@ -0,0 +1,5 @@
+import { dispatchSimpleAction } from "./utils";
+
+export default async function Command() {
+  await dispatchSimpleAction("stop_recording");
+}

apps/raycast/src/switch-camera.tsx

@@ -0,0 +1,21 @@
+import { ActionPanel, Action, Form } from "@raycast/api";
+import { dispatchAction } from "./utils";
+
+export default function Command() {
+  return (
+    <Form
+      actions={
+        <ActionPanel>
+          <Action.SubmitForm
+            title="Switch Camera"
+            onSubmit={async (values: { cameraLabel: string }) => {
+              await dispatchAction({ set_camera: { camera_label: values.cameraLabel || null } });
+            }}
+          />
+        </ActionPanel>
+      }
+    >
+      <Form.TextField id="cameraLabel" title="Camera Label" placeholder="FaceTime HD Camera" />
+    </Form>
+  );
+}

apps/raycast/src/switch-microphone.tsx

@@ -0,0 +1,21 @@
+import { ActionPanel, Action, Form } from "@raycast/api";
+import { dispatchAction } from "./utils";
+
+export default function Command() {
+  return (
+    <Form
+      actions={
+        <ActionPanel>
+          <Action.SubmitForm
+            title="Switch Microphone"
+            onSubmit={async (values: { micLabel: string }) => {
+              await dispatchAction({ set_microphone: { mic_label: values.micLabel || null } });
+            }}
+          />
+        </ActionPanel>
+      }
+    >
+      <Form.TextField id="micLabel" title="Microphone Label" placeholder="MacBook Pro Microphone" />
+    </Form>
+  );
+}

apps/raycast/src/toggle-pause-recording.ts

@@ -0,0 +1,5 @@
+import { dispatchSimpleAction } from "./utils";
+
+export default async function Command() {
+  await dispatchSimpleAction("toggle_pause_recording");
+}

apps/raycast/src/utils.ts

@@ -0,0 +1,35 @@
+import { closeMainWindow, showToast, Toast } from "@raycast/api";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+
+const execFileAsync = promisify(execFile);
+
+function toDeepLink(action: unknown) {
+  const value = encodeURIComponent(JSON.stringify(action));
+  return `cap-desktop://action?value=${value}`;
+}
+
+export async function dispatchAction(action: unknown) {
+  const url = toDeepLink(action);
+  await closeMainWindow();
+
+  try {
+    await execFileAsync("open", [url]);
+  } catch (error) {
+    await showToast({
+      style: Toast.Style.Failure,
+      title: "Failed to trigger Cap",
+      message: error instanceof Error ? error.message : String(error),
+    });
+    return;
+  }
+
+  await showToast({
+    style: Toast.Style.Success,
+    title: "Sent to Cap",
+  });
+}
+
+export async function dispatchSimpleAction(actionName: string) {
+  await dispatchAction({ [actionName]: null });
+}

apps/raycast/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "CommonJS",
+    "moduleResolution": "Node",
+    "jsx": "react-jsx",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "types": ["node"]
+  },
+  "include": ["src"]
+}