feat: add deeplink actions for recording control and Raycast extension

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

@@ -26,6 +26,18 @@ pub enum DeepLinkAction {
         mode: RecordingMode,
     },
     StopRecording,
+    PauseRecording,
+    ResumeRecording,
+    TogglePauseRecording,
+    RestartRecording,
+    TakeScreenshot,
+    SwitchMicrophone {
+        mic_label: String,
+    },
+    SwitchCamera {
+        camera: DeviceOrModelID,
+    },
+    RefreshRaycastDeviceCache,
     OpenEditor {
         project_path: PathBuf,
     },
@@ -88,7 +100,7 @@ impl TryFrom<&Url> for DeepLinkAction {
                 .map_err(|_| ActionParseFromUrlError::Invalid);
         }
 
-        match url.domain() {
+        match url.host_str() {
             Some(v) if v != "action" => Err(ActionParseFromUrlError::NotAction),
             _ => Err(ActionParseFromUrlError::Invalid),
         }?;
@@ -147,6 +159,44 @@ 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 => {
+                let displays = cap_recording::sources::screen_capture::list_displays();
+                let target = displays
+                    .into_iter()
+                    .next()
+                    .map(|(d, _)| ScreenCaptureTarget::Display { id: d.id })
+                    .ok_or("No display found")?;
+                crate::recording::take_screenshot(app.clone(), target)
+                    .await
+                    .map(|_| ())
+            }
+            DeepLinkAction::SwitchMicrophone { mic_label } => {
+                crate::set_mic_input(app.state(), Some(mic_label)).await
+            }
+            DeepLinkAction::SwitchCamera { camera } => {
+                crate::set_camera_input(app.clone(), app.state(), Some(camera), None).await
+            }
+            DeepLinkAction::RefreshRaycastDeviceCache => {
+                // Refresh by re-initializing the mic feed
+                let state: tauri::State<'_, ArcLock<App>> = app.state();
+                let mut app_state = state.write().await;
+                app_state.restart_mic_feed().await.map_err(|e| e.to_string())?;
+                Ok(())
+            }
             DeepLinkAction::OpenEditor { project_path } => {
                 crate::open_project_from_path(Path::new(&project_path), app.clone())
             }

apps/raycast/.gitignore

@@ -0,0 +1,3 @@
+dist/
+node_modules/
+*.log

apps/raycast/README.md

@@ -0,0 +1,20 @@
+# Cap Raycast Extension
+
+Control Cap screen recording directly from Raycast.
+
+## Commands
+
+- **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 Recording** — Toggle between pause and resume
+- **Restart Recording** — Restart the current recording
+- **Take Screenshot** — Capture a screenshot with Cap
+- **List Available Devices** — View connected cameras and microphones
+- **Switch Camera** — Select a different camera input
+- **Switch Microphone** — Select a different microphone input
+
+## How it Works
+
+The extension communicates with the Cap desktop app via custom `cap-desktop://` deeplinks.

apps/raycast/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "cap",
+  "title": "Cap",
+  "description": "Control Cap screen recording directly from Raycast",
+  "icon": "icon.png",
+  "author": "Cap",
+  "categories": ["Productivity", "Developer Tools"],
+  "license": "MIT",
+  "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-recording",
+      "title": "Toggle Pause Recording",
+      "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": "Capture a screenshot using Cap",
+      "mode": "no-view"
+    },
+    {
+      "name": "list-devices",
+      "title": "List Available Devices",
+      "subtitle": "Cap",
+      "description": "Show available cameras and microphones",
+      "mode": "view"
+    },
+    {
+      "name": "switch-camera",
+      "title": "Switch Camera",
+      "subtitle": "Cap",
+      "description": "Switch the camera input for recording",
+      "mode": "view"
+    },
+    {
+      "name": "switch-microphone",
+      "title": "Switch Microphone",
+      "subtitle": "Cap",
+      "description": "Switch the microphone input for recording",
+      "mode": "view"
+    }
+  ],
+  "dependencies": {
+    "@raycast/api": "^1.79.0"
+  },
+  "devDependencies": {
+    "@types/node": "20.14.9",
+    "typescript": "^5.5.3"
+  },
+  "scripts": {
+    "build": "ray build",
+    "dev": "ray develop"
+  }
+}

apps/raycast/src/list-devices.ts

@@ -0,0 +1,95 @@
+import { ActionPanel, Action, List, closeMainWindow, open } from "@raycast/api";
+import { useEffect, useState } from "react";
+
+interface Device {
+  name: string;
+  type: "camera" | "microphone";
+}
+
+export default function Command() {
+  const [devices, setDevices] = useState<Device[]>([]);
+  const [isLoading, setIsLoading] = useState(true);
+
+  useEffect(() => {
+    async function init() {
+      // Refresh device cache via deeplink
+      await open(
+        `cap-desktop://action?value=${encodeURIComponent(JSON.stringify("refresh_raycast_device_cache"))}`
+      );
+
+      // Populate with known device types — actual list comes from the Cap app
+      setDevices([
+        { name: "Built-in Camera", type: "camera" },
+        { name: "Built-in Microphone", type: "microphone" },
+      ]);
+      setIsLoading(false);
+    }
+
+    init();
+  }, []);
+
+  return (
+    <List isLoading={isLoading}>
+      <List.Section title="Cameras">
+        {devices
+          .filter((d) => d.type === "camera")
+          .map((device) => (
+            <List.Item
+              key={device.name}
+              title={device.name}
+              icon="📹"
+              actions={
+                <ActionPanel>
+                  <Action
+                    title="Select Camera"
+                    onAction={async () => {
+                      await closeMainWindow();
+                      await open(
+                        `cap-desktop://action?value=${encodeURIComponent(
+                          JSON.stringify({
+                            switch_camera: {
+                              camera: { DeviceID: device.name },
+                            },
+                          })
+                        )}`
+                      );
+                    }}
+                  />
+                </ActionPanel>
+              }
+            />
+          ))}
+      </List.Section>
+      <List.Section title="Microphones">
+        {devices
+          .filter((d) => d.type === "microphone")
+          .map((device) => (
+            <List.Item
+              key={device.name}
+              title={device.name}
+              icon="🎤"
+              actions={
+                <ActionPanel>
+                  <Action
+                    title="Select Microphone"
+                    onAction={async () => {
+                      await closeMainWindow();
+                      await open(
+                        `cap-desktop://action?value=${encodeURIComponent(
+                          JSON.stringify({
+                            switch_microphone: {
+                              mic_label: device.name,
+                            },
+                          })
+                        )}`
+                      );
+                    }}
+                  />
+                </ActionPanel>
+              }
+            />
+          ))}
+      </List.Section>
+    </List>
+  );
+}

apps/raycast/src/pause-recording.ts

@@ -0,0 +1,9 @@
+import { closeMainWindow, showHUD } from "@raycast/api";
+
+import { sendAction } from "./utils";
+
+export default async function Command() {
+  await closeMainWindow();
+  await sendAction("pause_recording");
+  await showHUD("Cap: Recording paused");
+}

apps/raycast/src/restart-recording.ts

@@ -0,0 +1,9 @@
+import { closeMainWindow, showHUD } from "@raycast/api";
+
+import { sendAction } from "./utils";
+
+export default async function Command() {
+  await closeMainWindow();
+  await sendAction("restart_recording");
+  await showHUD("Cap: Recording restarted");
+}

apps/raycast/src/resume-recording.ts

@@ -0,0 +1,9 @@
+import { closeMainWindow, showHUD } from "@raycast/api";
+
+import { sendAction } from "./utils";
+
+export default async function Command() {
+  await closeMainWindow();
+  await sendAction("resume_recording");
+  await showHUD("Cap: Recording resumed");
+}

apps/raycast/src/start-recording.ts

@@ -0,0 +1,25 @@
+import { LaunchProps, closeMainWindow, showHUD } from "@raycast/api";
+
+import { sendActionWithPayload } from "./utils";
+
+interface StartRecordingArguments {
+  captureMode?: string;
+  captureName?: string;
+}
+
+export default async function Command(props: LaunchProps<{ arguments: StartRecordingArguments }>) {
+  await closeMainWindow();
+
+  const captureMode = props.arguments.captureMode || "screen";
+  const captureName = props.arguments.captureName || undefined;
+
+  await sendActionWithPayload("start_recording", {
+    capture_mode: { [captureMode]: captureName },
+    camera: null,
+    mic_label: null,
+    capture_system_audio: false,
+    mode: "Instant",
+  });
+
+  await showHUD("Cap: Recording started");
+}

apps/raycast/src/stop-recording.ts

@@ -0,0 +1,9 @@
+import { closeMainWindow, showHUD } from "@raycast/api";
+
+import { sendAction } from "./utils";
+
+export default async function Command() {
+  await closeMainWindow();
+  await sendAction("stop_recording");
+  await showHUD("Cap: Recording stopped");
+}

apps/raycast/src/switch-camera.ts

@@ -0,0 +1,43 @@
+import { ActionPanel, Action, List, closeMainWindow, open } from "@raycast/api";
+
+interface SwitchCameraArguments {
+  camera?: string;
+}
+
+export default function Command(props: { arguments: SwitchCameraArguments }) {
+  const cameras = [
+    { name: "Built-in Camera", id: "built-in" },
+    { name: "External Camera", id: "external" },
+  ];
+
+  return (
+    <List>
+      {cameras.map((camera) => (
+        <List.Item
+          key={camera.id}
+          title={camera.name}
+          icon="📹"
+          actions={
+            <ActionPanel>
+              <Action
+                title="Switch to This Camera"
+                onAction={async () => {
+                  await closeMainWindow();
+                  await open(
+                    `cap-desktop://action?value=${encodeURIComponent(
+                      JSON.stringify({
+                        switch_camera: {
+                          camera: { DeviceID: props.arguments.camera || camera.name },
+                        },
+                      })
+                    )}`
+                  );
+                }}
+              />
+            </ActionPanel>
+          }
+        />
+      ))}
+    </List>
+  );
+}