# wmartins/walk-and-roll architecture

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

- Interactive diagram: https://gitdiagram.com/wmartins/walk-and-roll
- Repository: https://github.com/wmartins/walk-and-roll

## Overview

Walk & Roll is a native macOS app for recording product demos and exporting them as MP4. The workflow begins in the recorder UI: choose a window or display, configure audio, camera, and interaction overlays, record, then save an export. The recorder coordinates screen capture, optional camera and input monitoring, and export; export composes video and audio at the selected resolution. The README documents capabilities such as source selection and keystroke modes beyond the sampled excerpts, so those relationships are shown as documented rather than inferred from unsampled code.

Main entry points: [`WalkAndRoll/Recorder.swift`](https://github.com/wmartins/walk-and-roll/blob/main/WalkAndRoll/Recorder.swift) (Recording coordinator), [`WalkAndRoll/MP4Export.swift`](https://github.com/wmartins/walk-and-roll/blob/main/WalkAndRoll/MP4Export.swift) (MP4 export), [`WalkAndRoll/WalkAndRollApp.swift`](https://github.com/wmartins/walk-and-roll/blob/main/WalkAndRoll/WalkAndRollApp.swift) (Recorder UI), [`WalkAndRoll/CameraCapture.swift`](https://github.com/wmartins/walk-and-roll/blob/main/WalkAndRoll/CameraCapture.swift) (Camera capture)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and controls"]
  node_ui["Recorder UI"]
  node_coordinator["Recording coordinator<br/>[Recorder.swift]"]
end

subgraph group_capture["Recording capture"]
  node_screen["Screen capture<br/>[Recorder.swift]"]
  node_media["Recording media"]
end

subgraph group_inputs["Camera and interaction inputs"]
  node_camera["Camera capture"]
  node_input["Input tracking"]
  node_clicks["Click highlights"]
end

subgraph group_export["Composition and export"]
  node_exporter["MP4 export<br/>[MP4Export.swift]"]
  node_composition["Video composition"]
  node_saved["Saved MP4"]
end

node_creator(("Demo creator"))
node_capturekit["macOS sharing picker"]
node_macos["macOS capture and input APIs"]

node_creator -->|"configures recording"| node_ui
node_ui -->|"invokes controls"| node_coordinator
node_coordinator -->|"chooses source"| node_capturekit
node_coordinator -->|"starts capture"| node_screen
node_screen -.->|"records screen"| node_media
node_coordinator -->|"starts camera"| node_camera
node_camera -->|"writes camera clip"| node_media
node_coordinator -.->|"collects keystrokes"| node_input
node_coordinator -->|"tracks clicks"| node_clicks
node_macos -.->|"provides input events"| node_input
node_macos -.->|"provides screen capture"| node_screen
node_coordinator -->|"requests export"| node_exporter
node_exporter -->|"reads recordings"| node_media
node_exporter -->|"configures compositor"| node_composition
node_exporter -->|"writes MP4"| node_saved

click node_ui "https://github.com/wmartins/walk-and-roll/blob/main/WalkAndRoll/WalkAndRollApp.swift"
click node_coordinator "https://github.com/wmartins/walk-and-roll/blob/main/WalkAndRoll/Recorder.swift"
click node_screen "https://github.com/wmartins/walk-and-roll/blob/main/WalkAndRoll/Recorder.swift"
click node_camera "https://github.com/wmartins/walk-and-roll/blob/main/WalkAndRoll/CameraCapture.swift"
click node_input "https://github.com/wmartins/walk-and-roll/blob/main/WalkAndRoll/RecordingInput.swift"
click node_clicks "https://github.com/wmartins/walk-and-roll/blob/main/WalkAndRoll/RecordingInput.swift"
click node_exporter "https://github.com/wmartins/walk-and-roll/blob/main/WalkAndRoll/MP4Export.swift"
click node_composition "https://github.com/wmartins/walk-and-roll/blob/main/WalkAndRoll/RecordingComposition.swift"

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_ui,node_coordinator toneBlue
class node_screen,node_media toneAmber
class node_camera,node_input,node_clicks,node_macos toneMint
class node_exporter,node_composition,node_saved toneRose
class node_creator,node_capturekit toneIndigo
```

## Components

### App and controls

- [Recorder UI](https://github.com/wmartins/walk-and-roll/blob/main/WalkAndRoll/WalkAndRollApp.swift): `WalkAndRoll/WalkAndRollApp.swift`
- [Recording coordinator](https://github.com/wmartins/walk-and-roll/blob/main/WalkAndRoll/Recorder.swift): `WalkAndRoll/Recorder.swift`

### Recording capture

- [Screen capture](https://github.com/wmartins/walk-and-roll/blob/main/WalkAndRoll/Recorder.swift): `WalkAndRoll/Recorder.swift`
- **Recording media**

### Camera and interaction inputs

- [Camera capture](https://github.com/wmartins/walk-and-roll/blob/main/WalkAndRoll/CameraCapture.swift): `WalkAndRoll/CameraCapture.swift`
- [Input tracking](https://github.com/wmartins/walk-and-roll/blob/main/WalkAndRoll/RecordingInput.swift): `WalkAndRoll/RecordingInput.swift`
- [Click highlights](https://github.com/wmartins/walk-and-roll/blob/main/WalkAndRoll/RecordingInput.swift): `WalkAndRoll/RecordingInput.swift`

### Composition and export

- [MP4 export](https://github.com/wmartins/walk-and-roll/blob/main/WalkAndRoll/MP4Export.swift): `WalkAndRoll/MP4Export.swift`
- [Video composition](https://github.com/wmartins/walk-and-roll/blob/main/WalkAndRoll/RecordingComposition.swift): `WalkAndRoll/RecordingComposition.swift`
- **Saved MP4**

### Other components

- **Demo creator**
- **macOS sharing picker**
- **macOS capture and input APIs**

## Connections

- Demo creator → Recorder UI: configures recording (evidence: `README.md`)
- Recorder UI → Recording coordinator: invokes controls (evidence: `WalkAndRoll/WalkAndRollApp.swift`)
- Recording coordinator → macOS sharing picker: chooses source (evidence: `WalkAndRoll/Recorder.swift`)
- Recording coordinator → Screen capture: starts capture (evidence: `WalkAndRoll/Recorder.swift`)
- Screen capture → Recording media: records screen
- Recording coordinator → Camera capture: starts camera (evidence: `WalkAndRoll/Recorder.swift`)
- Camera capture → Recording media: writes camera clip (evidence: `WalkAndRoll/CameraCapture.swift`)
- Recording coordinator → Input tracking: collects keystrokes
- Recording coordinator → Click highlights: tracks clicks (evidence: `WalkAndRoll/Recorder.swift`)
- macOS capture and input APIs → Input tracking: provides input events
- macOS capture and input APIs → Screen capture: provides screen capture
- Recording coordinator → MP4 export: requests export (evidence: `WalkAndRoll/Recorder.swift`)
- MP4 export → Recording media: reads recordings (evidence: `WalkAndRoll/MP4Export.swift`)
- MP4 export → Video composition: configures compositor (evidence: `WalkAndRoll/MP4Export.swift`)
- MP4 export → Saved MP4: writes MP4 (evidence: `WalkAndRoll/MP4Export.swift`)
