# capsoftware/cap architecture

> Architecture diagram of the GitHub repository capsoftware/cap, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-10). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/capsoftware/cap
- Repository: https://github.com/capsoftware/cap

## Overview

Cap is a cross-platform screen-recording and sharing product. The main user journey is to capture screen, camera, and audio; edit or export a polished recording, or use Instant Mode for a fast share link; then manage and share recordings through the web dashboard. The graph also preserves documented storage, collaboration, AI, Loom import, and CLI capabilities. README statements support the product-level links; sampled source was limited, so internal and unsampled subsystem wiring is not inferred.

Main entry points: [`apps/desktop-gpui/src/editor_canvas.rs`](https://github.com/capsoftware/cap/blob/main/apps/desktop-gpui/src/editor_canvas.rs) (Editor), [`apps/desktop-gpui`](https://github.com/capsoftware/cap/tree/main/apps/desktop-gpui) (Desktop app), [`apps/cli/src/main.rs`](https://github.com/capsoftware/cap/blob/main/apps/cli/src/main.rs) (Cap CLI), [`apps/web`](https://github.com/capsoftware/cap/tree/main/apps/web) (Web dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Capture and recording"]
  node_desktop["Desktop app"]
  node_recording["Recording UI<br/>[app_windows.rs]"]
  node_capture_pipeline["Capture pipeline"]
  node_camera["Camera effects<br/>[blur_pipeline.rs]"]
end

subgraph group_editing["Editing and export"]
  node_editor["Editor<br/>[editor_canvas.rs]"]
  node_clips["Clip editing<br/>[editor_clips.rs]"]
  node_crop["Crop tools<br/>[editor_crop.rs]"]
  node_edit_state["Edit operations<br/>[editor_edits.rs]"]
  node_export["Export<br/>[editor_export.rs]"]
  node_rendering["Frame rendering<br/>[frame_pipeline.rs]"]
end

subgraph group_sharing["Web and collaboration"]
  node_web["Web dashboard"]
  node_sharing_actions["Sharing and collaboration<br/>[share.ts]"]
  node_analytics["Viewer analytics"]
  node_ai["AI transcripts"]
  node_loom_import["Loom import"]
end

subgraph group_services["Media and storage"]
  node_media_server["Media processing"]
  node_storage_api["Storage management<br/>[storage.ts]"]
  node_storage_repo["Storage repository<br/>[StorageRepo.ts]"]
end

subgraph group_cli["Command line"]
  node_cli["Cap CLI<br/>[main.rs]"]
  node_cli_record["CLI recording<br/>[record.rs]"]
  node_cli_caps["Cap commands<br/>[caps.rs]"]
  node_cli_export["CLI export<br/>[export.rs]"]
end

node_user(("Recorder or viewer"))

node_user -->|"records with"| node_desktop
node_desktop -->|"offers recording"| node_recording
node_recording -->|"captures media"| node_capture_pipeline
node_recording -.->|"captures camera"| node_camera
node_desktop -->|"opens editor"| node_editor
node_editor -->|"trims clips"| node_clips
node_editor -.->|"edits framing"| node_crop
node_editor -.->|"applies edits"| node_edit_state
node_editor -.->|"renders frames"| node_rendering
node_editor -->|"exports video"| node_export
node_user -->|"views recordings"| node_web
node_desktop -->|"shares recording"| node_web
node_web -.->|"manages sharing"| node_sharing_actions
node_web -->|"shows analytics"| node_analytics
node_media_server -.->|"generates transcripts"| node_ai
node_media_server -.->|"imports Loom videos"| node_loom_import
node_user -->|"configures storage"| node_storage_api
node_storage_api -.->|"manages integrations"| node_storage_repo
node_user -->|"runs commands"| node_cli
node_cli -.->|"records media"| node_cli_record
node_cli -.->|"manages Caps"| node_cli_caps
node_cli -.->|"exports media"| node_cli_export

click node_desktop "https://github.com/capsoftware/cap/tree/main/apps/desktop-gpui"
click node_recording "https://github.com/capsoftware/cap/blob/main/apps/desktop-gpui/src/app_windows.rs"
click node_capture_pipeline "https://github.com/capsoftware/cap/blob/main/crates/recording/src/capture_pipeline.rs"
click node_camera "https://github.com/capsoftware/cap/blob/main/crates/camera-effects/src/blur_pipeline.rs"
click node_editor "https://github.com/capsoftware/cap/blob/main/apps/desktop-gpui/src/editor_canvas.rs"
click node_clips "https://github.com/capsoftware/cap/blob/main/apps/desktop-gpui/src/editor_clips.rs"
click node_crop "https://github.com/capsoftware/cap/blob/main/apps/desktop-gpui/src/editor_crop.rs"
click node_edit_state "https://github.com/capsoftware/cap/blob/main/apps/desktop-gpui/src/editor_edits.rs"
click node_export "https://github.com/capsoftware/cap/blob/main/apps/desktop-gpui/src/editor_export.rs"
click node_rendering "https://github.com/capsoftware/cap/blob/main/crates/rendering/src/frame_pipeline.rs"
click node_web "https://github.com/capsoftware/cap/tree/main/apps/web"
click node_sharing_actions "https://github.com/capsoftware/cap/blob/main/apps/web/actions/caps/share.ts"
click node_analytics "https://github.com/capsoftware/cap/tree/main/apps/web"
click node_ai "https://github.com/capsoftware/cap/tree/main/apps/web"
click node_loom_import "https://github.com/capsoftware/cap/tree/main/apps/media-server/src/loom-importer"
click node_media_server "https://github.com/capsoftware/cap/tree/main/apps/media-server"
click node_storage_api "https://github.com/capsoftware/cap/blob/main/apps/web/actions/organization/storage.ts"
click node_storage_repo "https://github.com/capsoftware/cap/blob/main/packages/web-backend/src/Storage/StorageRepo.ts"
click node_cli "https://github.com/capsoftware/cap/blob/main/apps/cli/src/main.rs"
click node_cli_record "https://github.com/capsoftware/cap/blob/main/apps/cli/src/record.rs"
click node_cli_caps "https://github.com/capsoftware/cap/blob/main/apps/cli/src/caps.rs"
click node_cli_export "https://github.com/capsoftware/cap/blob/main/apps/cli/src/export.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_desktop,node_recording,node_capture_pipeline,node_camera,node_user toneBlue
class node_editor,node_clips,node_crop,node_edit_state,node_export,node_rendering toneAmber
class node_web,node_sharing_actions,node_analytics,node_ai,node_loom_import toneMint
class node_media_server,node_storage_api,node_storage_repo toneRose
class node_cli,node_cli_record,node_cli_caps,node_cli_export toneIndigo
```

## Components

### Capture and recording

- [Desktop app](https://github.com/capsoftware/cap/tree/main/apps/desktop-gpui): `apps/desktop-gpui`
- [Recording UI](https://github.com/capsoftware/cap/blob/main/apps/desktop-gpui/src/app_windows.rs): `apps/desktop-gpui/src/app_windows.rs`
- [Capture pipeline](https://github.com/capsoftware/cap/blob/main/crates/recording/src/capture_pipeline.rs): `crates/recording/src/capture_pipeline.rs`
- [Camera effects](https://github.com/capsoftware/cap/blob/main/crates/camera-effects/src/blur_pipeline.rs): `crates/camera-effects/src/blur_pipeline.rs`

### Editing and export

- [Editor](https://github.com/capsoftware/cap/blob/main/apps/desktop-gpui/src/editor_canvas.rs): `apps/desktop-gpui/src/editor_canvas.rs`
- [Clip editing](https://github.com/capsoftware/cap/blob/main/apps/desktop-gpui/src/editor_clips.rs): `apps/desktop-gpui/src/editor_clips.rs`
- [Crop tools](https://github.com/capsoftware/cap/blob/main/apps/desktop-gpui/src/editor_crop.rs): `apps/desktop-gpui/src/editor_crop.rs`
- [Edit operations](https://github.com/capsoftware/cap/blob/main/apps/desktop-gpui/src/editor_edits.rs): `apps/desktop-gpui/src/editor_edits.rs`
- [Export](https://github.com/capsoftware/cap/blob/main/apps/desktop-gpui/src/editor_export.rs): `apps/desktop-gpui/src/editor_export.rs`
- [Frame rendering](https://github.com/capsoftware/cap/blob/main/crates/rendering/src/frame_pipeline.rs): `crates/rendering/src/frame_pipeline.rs`

### Web and collaboration

- [Web dashboard](https://github.com/capsoftware/cap/tree/main/apps/web): `apps/web`
- [Sharing and collaboration](https://github.com/capsoftware/cap/blob/main/apps/web/actions/caps/share.ts): `apps/web/actions/caps/share.ts`
- [Viewer analytics](https://github.com/capsoftware/cap/tree/main/apps/web): `apps/web`
- [AI transcripts](https://github.com/capsoftware/cap/tree/main/apps/web): `apps/web`
- [Loom import](https://github.com/capsoftware/cap/tree/main/apps/media-server/src/loom-importer): `apps/media-server/src/loom-importer`

### Media and storage

- [Media processing](https://github.com/capsoftware/cap/tree/main/apps/media-server): `apps/media-server`
- [Storage management](https://github.com/capsoftware/cap/blob/main/apps/web/actions/organization/storage.ts): `apps/web/actions/organization/storage.ts`
- [Storage repository](https://github.com/capsoftware/cap/blob/main/packages/web-backend/src/Storage/StorageRepo.ts): `packages/web-backend/src/Storage/StorageRepo.ts`

### Command line

- [Cap CLI](https://github.com/capsoftware/cap/blob/main/apps/cli/src/main.rs): `apps/cli/src/main.rs`
- [CLI recording](https://github.com/capsoftware/cap/blob/main/apps/cli/src/record.rs): `apps/cli/src/record.rs`
- [Cap commands](https://github.com/capsoftware/cap/blob/main/apps/cli/src/caps.rs): `apps/cli/src/caps.rs`
- [CLI export](https://github.com/capsoftware/cap/blob/main/apps/cli/src/export.rs): `apps/cli/src/export.rs`

### Other components

- **Recorder or viewer**

## Connections

- Recorder or viewer → Desktop app: records with (evidence: `README.md`)
- Desktop app → Recording UI: offers recording (evidence: `README.md`)
- Recording UI → Capture pipeline: captures media (evidence: `README.md`)
- Recording UI → Camera effects: captures camera
- Desktop app → Editor: opens editor (evidence: `README.md`)
- Editor → Clip editing: trims clips (evidence: `README.md`)
- Editor → Crop tools: edits framing
- Editor → Edit operations: applies edits
- Editor → Frame rendering: renders frames
- Editor → Export: exports video (evidence: `README.md`)
- Recorder or viewer → Web dashboard: views recordings (evidence: `README.md`)
- Desktop app → Web dashboard: shares recording (evidence: `README.md`)
- Web dashboard → Sharing and collaboration: manages sharing
- Web dashboard → Viewer analytics: shows analytics (evidence: `README.md`)
- Media processing → AI transcripts: generates transcripts
- Media processing → Loom import: imports Loom videos
- Recorder or viewer → Storage management: configures storage (evidence: `README.md`)
- Storage management → Storage repository: manages integrations
- Recorder or viewer → Cap CLI: runs commands (evidence: `README.md`)
- Cap CLI → CLI recording: records media (evidence: `apps/cli/src/main.rs`)
- Cap CLI → Cap commands: manages Caps (evidence: `apps/cli/src/main.rs`)
- Cap CLI → CLI export: exports media (evidence: `apps/cli/src/main.rs`)
