feat: extend deeplinks + add Raycast extension

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

@@ -26,6 +26,15 @@ pub enum DeepLinkAction {
         mode: RecordingMode,
     },
     StopRecording,
+    PauseRecording,
+    ResumeRecording,
+    TogglePauseRecording,
+    SwitchMicrophone {
+        label: Option<String>,
+    },
+    SwitchCamera {
+        camera: Option<DeviceOrModelID>,
+    },
     OpenEditor {
         project_path: PathBuf,
     },
@@ -147,6 +156,23 @@ 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::SwitchMicrophone { label } => {
+                let state = app.state::<ArcLock<App>>();
+                crate::set_mic_input(state, label).await
+            }
+            DeepLinkAction::SwitchCamera { camera } => {
+                let state = app.state::<ArcLock<App>>();
+                crate::set_camera_input(app.clone(), state, camera, None).await
+            }
             DeepLinkAction::OpenEditor { project_path } => {
                 crate::open_project_from_path(Path::new(&project_path), app.clone())
             }

extensions/raycast/README.md

@@ -0,0 +1,43 @@
+# 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 |
+| **Toggle Pause** | Pause or resume the current recording |
+| **Open Cap** | Open the Cap application |
+| **Open Settings** | Open Cap settings |
+| **Recent Recordings** | Browse your recent recordings |
+
+## Requirements
+
+- [Cap](https://cap.so) desktop app installed
+- macOS
+
+## How it works
+
+This extension communicates with Cap via the `cap-desktop://` deep link URL scheme. All commands are executed instantly without opening any UI (except "Recent Recordings" which shows a list view).
+
+## Deep Link Format
+
+Cap uses the following deep link format:
+
+```
+cap-desktop://action?value=<JSON-encoded-action>
+```
+
+### Supported Actions
+
+- `start_recording` — Start recording with capture mode, camera, mic options
+- `stop_recording` — Stop the current recording
+- `pause_recording` — Pause the current recording
+- `resume_recording` — Resume a paused recording
+- `toggle_pause_recording` — Toggle pause/resume
+- `open_editor` — Open a recording in the editor
+- `open_settings` — Open Cap settings
+- `switch_microphone` — Switch to a different microphone
+- `switch_camera` — Switch to a different camera

extensions/raycast/package.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://www.raycast.com/schemas/extension.json",
+  "name": "cap",
+  "title": "Cap",
+  "description": "Control Cap screen recorder — start, stop, pause, and resume recordings directly from Raycast",
+  "icon": "cap-icon.png",
+  "author": "cap",
+  "categories": ["Productivity", "Applications"],
+  "license": "AGPL-3.0",
+  "commands": [
+    {
+      "name": "start-recording",
+      "title": "Start Recording",
+      "description": "Start a new screen recording with Cap",
+      "mode": "no-view",
+      "keywords": ["record", "screen", "capture"]
+    },
+    {
+      "name": "stop-recording",
+      "title": "Stop Recording",
+      "description": "Stop the current recording",
+      "mode": "no-view",
+      "keywords": ["stop", "end", "finish"]
+    },
+    {
+      "name": "toggle-pause",
+      "title": "Toggle Pause",
+      "description": "Pause or resume the current recording",
+      "mode": "no-view",
+      "keywords": ["pause", "resume", "toggle"]
+    },
+    {
+      "name": "open-cap",
+      "title": "Open Cap",
+      "description": "Open the Cap application",
+      "mode": "no-view",
+      "keywords": ["open", "launch"]
+    },
+    {
+      "name": "open-settings",
+      "title": "Open Settings",
+      "description": "Open Cap settings",
+      "mode": "no-view",
+      "keywords": ["settings", "preferences", "config"]
+    },
+    {
+      "name": "recent-recordings",
+      "title": "Recent Recordings",
+      "description": "Browse your recent Cap recordings",
+      "mode": "view",
+      "keywords": ["recent", "history", "list", "browse"]
+    }
+  ],
+  "dependencies": {
+    "@raycast/api": "^1.83.1",
+    "@raycast/utils": "^1.17.0"
+  },
+  "devDependencies": {
+    "@raycast/eslint-config": "^1.0.11",
+    "@types/node": "22.5.4",
+    "@types/react": "18.3.3",
+    "eslint": "^8.57.0",
+    "prettier": "^3.3.3",
+    "typescript": "^5.4.5"
+  },
+  "scripts": {
+    "build": "ray build",
+    "dev": "ray develop",
+    "fix-lint": "ray lint --fix",
+    "lint": "ray lint"
+  }
+}

extensions/raycast/src/open-cap.ts

@@ -0,0 +1,11 @@
+import { showHUD } from "@raycast/api";
+import { openCap } from "./utils";
+
+export default async function command() {
+  try {
+    await openCap();
+    await showHUD("🎬 Opening Cap...");
+  } catch {
+    await showHUD("❌ Failed to open Cap. Is it installed?");
+  }
+}

extensions/raycast/src/open-settings.ts

@@ -0,0 +1,12 @@
+import { showHUD } from "@raycast/api";
+import { sendDeepLink } from "./utils";
+
+export default async function command() {
+  try {
+    // serde struct variant with optional field
+    await sendDeepLink({ open_settings: { page: null } });
+    await showHUD("⚙️ Cap: Opening settings...");
+  } catch {
+    await showHUD("❌ Failed to open settings. Is Cap running?");
+  }
+}

extensions/raycast/src/recent-recordings.tsx

@@ -0,0 +1,71 @@
+import { Action, ActionPanel, List, open, showHUD } from "@raycast/api";
+import { useState, useEffect } from "react";
+import { readdirSync, statSync, existsSync } from "fs";
+import { join } from "path";
+import { getRecordingsDir } from "./utils";
+
+interface Recording {
+  name: string;
+  path: string;
+  date: Date;
+}
+
+function getRecordings(): Recording[] {
+  const dir = getRecordingsDir();
+  if (!existsSync(dir)) return [];
+
+  try {
+    return readdirSync(dir)
+      .map((name) => {
+        const fullPath = join(dir, name);
+        const stat = statSync(fullPath);
+        return { name, path: fullPath, stat };
+      })
+      .filter(({ name, stat }) => name.endsWith(".cap") && stat.isDirectory())
+      .map(({ name, path, stat }) => ({ name, path, date: stat.mtime }))
+      .sort((a, b) => b.date.getTime() - a.date.getTime())
+      .slice(0, 50);
+  } catch {
+    return [];
+  }
+}
+
+export default function Command() {
+  const [recordings, setRecordings] = useState<Recording[]>([]);
+  const [isLoading, setIsLoading] = useState(true);
+
+  useEffect(() => {
+    setRecordings(getRecordings());
+    setIsLoading(false);
+  }, []);
+
+  return (
+    <List isLoading={isLoading} searchBarPlaceholder="Search recordings...">
+      {recordings.length === 0 ? (
+        <List.EmptyView title="No recordings found" description="Record something with Cap first!" />
+      ) : (
+        recordings.map((rec) => (
+          <List.Item
+            key={rec.path}
+            title={rec.name}
+            subtitle={rec.date.toLocaleDateString()}
+            accessories={[{ date: rec.date }]}
+            actions={
+              <ActionPanel>
+                <Action
+                  title="Open in Cap"
+                  onAction={async () => {
+                    await open(`file://${encodeURI(rec.path)}`);
+                    await showHUD("Opening in Cap...");
+                  }}
+                />
+                <Action.ShowInFinder path={rec.path} />
+                <Action.CopyToClipboard title="Copy Path" content={rec.path} />
+              </ActionPanel>
+            }
+          />
+        ))
+      )}
+    </List>
+  );
+}

extensions/raycast/src/start-recording.ts

@@ -0,0 +1,20 @@
+import { showHUD } from "@raycast/api";
+import { sendDeepLink } from "./utils";
+
+export default async function command() {
+  try {
+    // serde externally-tagged struct variant
+    await sendDeepLink({
+      start_recording: {
+        capture_mode: { screen: "Main Display" },
+        camera: null,
+        mic_label: null,
+        capture_system_audio: false,
+        mode: "instant",
+      },
+    });
+    await showHUD("🔴 Cap: Recording started");
+  } catch {
+    await showHUD("❌ Failed to start recording. Is Cap running?");
+  }
+}

extensions/raycast/src/stop-recording.ts

@@ -0,0 +1,12 @@
+import { showHUD } from "@raycast/api";
+import { sendDeepLink } from "./utils";
+
+export default async function command() {
+  try {
+    // serde unit variant
+    await sendDeepLink("stop_recording");
+    await showHUD("⏹ Cap: Recording stopped");
+  } catch {
+    await showHUD("❌ Failed to stop recording. Is Cap running?");
+  }
+}

extensions/raycast/src/toggle-pause.ts

@@ -0,0 +1,12 @@
+import { showHUD } from "@raycast/api";
+import { sendDeepLink } from "./utils";
+
+export default async function command() {
+  try {
+    // serde unit variant
+    await sendDeepLink("toggle_pause_recording");
+    await showHUD("⏯ Cap: Toggled pause");
+  } catch {
+    await showHUD("❌ Failed to toggle pause. Is Cap running?");
+  }
+}

extensions/raycast/src/utils.ts

@@ -0,0 +1,33 @@
+import { open, showHUD } from "@raycast/api";
+
+const CAP_DEEPLINK_SCHEME = "cap-desktop://";
+
+/**
+ * Send a deep link action to the Cap desktop app.
+ * URL format: cap-desktop://action?value=<JSON-encoded serde enum>
+ *
+ * The `value` parameter is the serde-serialized DeepLinkAction enum.
+ * For unit variants: `"stop_recording"` (just a string)
+ * For struct variants: `{"start_recording": { ... }}`
+ */
+export async function sendDeepLink(value: string | Record<string, unknown>): Promise<void> {
+  const encodedValue = encodeURIComponent(JSON.stringify(value));
+  const url = `${CAP_DEEPLINK_SCHEME}action?value=${encodedValue}`;
+  await open(url);
+}
+
+/**
+ * Open the Cap app without a specific action.
+ */
+export async function openCap(): Promise<void> {
+  await open(CAP_DEEPLINK_SCHEME);
+}
+
+/**
+ * Get the Cap recordings directory path.
+ * Cap (Tauri) stores recordings under the app data directory.
+ */
+export function getRecordingsDir(): string {
+  const home = process.env.HOME || "~";
+  return `${home}/Library/Application Support/so.cap.desktop/recordings`;
+}

extensions/raycast/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    "strict": true,
+    "jsx": "react-jsx",
+    "module": "ES2022",
+    "moduleResolution": "bundler",
+    "target": "ES2022",
+    "lib": ["ES2022"],
+    "resolveJsonModule": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*", "env.d.ts"]
+}