# rsaiteja13-lab/meetmemento architecture

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

- Interactive diagram: https://gitdiagram.com/rsaiteja13-lab/meetmemento
- Repository: https://github.com/rsaiteja13-lab/meetmemento

## Overview

MeetMemento is a local meeting recorder for macOS and Windows. Zoom detection initiates automatic capture (or the user starts it manually); the app saves meeting video and audio, produces a timestamped transcript, and presents recordings for review, export, or deletion. The macOS implementation has separate system-audio/video and microphone capture, while Windows uses its own Electron capture and persistence path. README documents major capabilities on both platforms; some Windows internals and several macOS subsystems are represented by their exact source paths because their implementation excerpts were not provided.

Main entry points: [`Sources/MeetMemento/AppModel.swift`](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/AppModel.swift) (macOS app model), [`Windows/src/main.js`](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Windows/src/main.js) (Electron main process), [`Sources/MeetMemento/MeetingLibrary.swift`](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/MeetingLibrary.swift) (Meeting library), [`Sources/MeetMemento/MeetingCaptureController.swift`](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/MeetingCaptureController.swift) (Capture controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mac_capture["macOS Detection &amp; Capture"]
  node_zoom_detect["Zoom detector"]
  node_capture_controller["Capture controller"]
  node_screen_audio["Screen &amp; system audio"]
  node_mic_capture["Microphone capture"]
end

subgraph group_mac_processing["macOS Processing &amp; Storage"]
  node_chunker["Audio chunker<br/>[AudioChunker.swift]"]
  node_transcriber["Speech transcriber"]
  node_formatter["Transcript formatter"]
  node_audio_mixer["Audio mixer"]
  node_calendar_match["Calendar matcher"]
  node_meeting_namer["Meeting namer<br/>[MeetingNamer.swift]"]
  node_video_validator["Video validator"]
end

subgraph group_mac_app["macOS App &amp; Library"]
  node_mac_app["macOS app model<br/>[AppModel.swift]"]
  node_library[("Meeting library")]
  node_content_view["Main meeting view<br/>[ContentView.swift]"]
  node_detail_view["Meeting details"]
  node_menu_view["Menu bar<br/>[MenuBarView.swift]"]
  node_onboarding["Onboarding"]
  node_settings_view["Settings<br/>[SettingsView.swift]"]
  node_settings["App settings<br/>[AppSettings.swift]"]
  node_permissions["Permissions<br/>[Permissions.swift]"]
  node_diagnostics["Diagnostics"]
  node_guardian["Background guardian manager"]
  node_keeper["Guardian helper<br/>[main.swift]"]
end

subgraph group_windows_app["Windows Recording App"]
  node_windows_main["Electron main process<br/>[main.js]"]
  node_windows_detector["Zoom detector<br/>[zoom-detector.js]"]
  node_windows_writer["Recording writer"]
  node_windows_store[("Meeting store<br/>[meeting-store.js]")]
  node_windows_settings[("Settings store<br/>[settings-store.js]")]
  node_recovery["Capture recovery"]
  node_transcript_service["Transcript service"]
  node_transcript_format["Transcript formatter"]
  node_preload["Renderer bridge<br/>[preload.js]"]
end

node_user(("User"))
node_zoom["Zoom meeting"]

node_user -->|"starts or reviews"| node_mac_app
node_zoom -->|"provides meeting signals"| node_zoom_detect
node_mac_app -->|"checks meetings"| node_zoom_detect
node_mac_app -->|"starts capture"| node_capture_controller
node_capture_controller -->|"starts and stops"| node_screen_audio
node_capture_controller -->|"starts and stops"| node_mic_capture
node_screen_audio -->|"saves capture files"| node_library
node_mic_capture -->|"saves microphone track"| node_library
node_mac_app -->|"splits transcription work"| node_chunker
node_mac_app -->|"transcribes audio"| node_transcriber
node_mac_app -->|"formats transcript"| node_formatter
node_mac_app -->|"combines audio tracks"| node_audio_mixer
node_mac_app -->|"matches calendar event"| node_calendar_match
node_mac_app -->|"names meeting"| node_meeting_namer
node_mac_app -->|"validates saved video"| node_video_validator
node_mac_app -->|"manages recordings"| node_library
node_user -->|"uses"| node_content_view
node_content_view -->|"controls recording"| node_mac_app
node_content_view -->|"browses recordings"| node_library
node_detail_view -->|"requests meeting actions"| node_mac_app
node_menu_view -->|"controls capture"| node_mac_app
node_onboarding -->|"completes setup"| node_mac_app
node_settings_view -->|"updates preferences"| node_settings
node_mac_app -->|"checks access"| node_permissions
node_settings -->|"installs guardian"| node_guardian
node_guardian -->|"registers helper"| node_keeper
node_mac_app -->|"records diagnostics"| node_diagnostics
node_user -->|"uses"| node_windows_main
node_windows_main -->|"checks Zoom meetings"| node_windows_detector
node_windows_main -->|"writes capture"| node_windows_writer
node_windows_main -->|"manages recordings"| node_windows_store
node_windows_main -->|"reads and updates"| node_windows_settings
node_windows_main -->|"uses recovery"| node_recovery
node_windows_main -->|"requests transcription"| node_transcript_service
node_transcript_service -->|"formats segments"| node_transcript_format
node_windows_store -->|"repairs audio header"| node_windows_writer
node_windows_writer -->|"writes metadata atomically"| node_windows_settings
node_preload -.->|"bridges renderer IPC"| node_windows_main

click node_mac_app "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/AppModel.swift"
click node_zoom_detect "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/ZoomMeetingDetector.swift"
click node_capture_controller "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/MeetingCaptureController.swift"
click node_screen_audio "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/SystemAudioCapture.swift"
click node_mic_capture "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/MicrophoneCapture.swift"
click node_chunker "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/AudioChunker.swift"
click node_transcriber "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/SpeechTranscriber.swift"
click node_formatter "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/TranscriptFormatter.swift"
click node_audio_mixer "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/MeetingAudioMixer.swift"
click node_calendar_match "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/CalendarEventMatcher.swift"
click node_meeting_namer "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/MeetingNamer.swift"
click node_video_validator "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/MeetingVideoValidator.swift"
click node_library "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/MeetingLibrary.swift"
click node_content_view "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/ContentView.swift"
click node_detail_view "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/MeetingDetailView.swift"
click node_menu_view "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/MenuBarView.swift"
click node_onboarding "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/OnboardingView.swift"
click node_settings_view "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/SettingsView.swift"
click node_settings "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/AppSettings.swift"
click node_permissions "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/Permissions.swift"
click node_diagnostics "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/AppDiagnostics.swift"
click node_guardian "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/BackgroundGuardianManager.swift"
click node_keeper "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMementoKeeper/main.swift"
click node_windows_main "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Windows/src/main.js"
click node_windows_detector "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Windows/src/lib/zoom-detector.js"
click node_windows_writer "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Windows/src/lib/recording-writer.js"
click node_windows_store "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Windows/src/lib/meeting-store.js"
click node_windows_settings "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Windows/src/lib/settings-store.js"
click node_recovery "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Windows/src/lib/capture-recovery.js"
click node_transcript_service "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Windows/src/lib/transcript-service.js"
click node_transcript_format "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Windows/src/lib/transcript-format.js"
click node_preload "https://github.com/rsaiteja13-lab/meetmemento/blob/main/Windows/src/preload.js"

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_zoom_detect,node_capture_controller,node_screen_audio,node_mic_capture,node_user toneBlue
class node_chunker,node_transcriber,node_formatter,node_audio_mixer,node_calendar_match,node_meeting_namer,node_video_validator toneAmber
class node_mac_app,node_library,node_content_view,node_detail_view,node_menu_view,node_onboarding,node_settings_view,node_settings,node_permissions,node_diagnostics,node_guardian,node_keeper toneMint
class node_windows_main,node_windows_detector,node_windows_writer,node_windows_store,node_windows_settings,node_recovery,node_transcript_service,node_transcript_format,node_preload toneRose
class node_zoom toneIndigo
```

## Components

### macOS Detection & Capture

- [Zoom detector](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/ZoomMeetingDetector.swift): `Sources/MeetMemento/ZoomMeetingDetector.swift`
- [Capture controller](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/MeetingCaptureController.swift): `Sources/MeetMemento/MeetingCaptureController.swift`
- [Screen & system audio](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/SystemAudioCapture.swift): `Sources/MeetMemento/SystemAudioCapture.swift`
- [Microphone capture](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/MicrophoneCapture.swift): `Sources/MeetMemento/MicrophoneCapture.swift`

### macOS Processing & Storage

- [Audio chunker](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/AudioChunker.swift): `Sources/MeetMemento/AudioChunker.swift`
- [Speech transcriber](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/SpeechTranscriber.swift): `Sources/MeetMemento/SpeechTranscriber.swift`
- [Transcript formatter](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/TranscriptFormatter.swift): `Sources/MeetMemento/TranscriptFormatter.swift`
- [Audio mixer](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/MeetingAudioMixer.swift): `Sources/MeetMemento/MeetingAudioMixer.swift`
- [Calendar matcher](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/CalendarEventMatcher.swift): `Sources/MeetMemento/CalendarEventMatcher.swift`
- [Meeting namer](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/MeetingNamer.swift): `Sources/MeetMemento/MeetingNamer.swift`
- [Video validator](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/MeetingVideoValidator.swift): `Sources/MeetMemento/MeetingVideoValidator.swift`

### macOS App & Library

- [macOS app model](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/AppModel.swift): `Sources/MeetMemento/AppModel.swift`
- [Meeting library](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/MeetingLibrary.swift): `Sources/MeetMemento/MeetingLibrary.swift`
- [Main meeting view](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/ContentView.swift): `Sources/MeetMemento/ContentView.swift`
- [Meeting details](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/MeetingDetailView.swift): `Sources/MeetMemento/MeetingDetailView.swift`
- [Menu bar](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/MenuBarView.swift): `Sources/MeetMemento/MenuBarView.swift`
- [Onboarding](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/OnboardingView.swift): `Sources/MeetMemento/OnboardingView.swift`
- [Settings](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/SettingsView.swift): `Sources/MeetMemento/SettingsView.swift`
- [App settings](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/AppSettings.swift): `Sources/MeetMemento/AppSettings.swift`
- [Permissions](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/Permissions.swift): `Sources/MeetMemento/Permissions.swift`
- [Diagnostics](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/AppDiagnostics.swift): `Sources/MeetMemento/AppDiagnostics.swift`
- [Background guardian manager](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMemento/BackgroundGuardianManager.swift): `Sources/MeetMemento/BackgroundGuardianManager.swift`
- [Guardian helper](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Sources/MeetMementoKeeper/main.swift): `Sources/MeetMementoKeeper/main.swift`

### Windows Recording App

- [Electron main process](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Windows/src/main.js): `Windows/src/main.js`
- [Zoom detector](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Windows/src/lib/zoom-detector.js): `Windows/src/lib/zoom-detector.js`
- [Recording writer](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Windows/src/lib/recording-writer.js): `Windows/src/lib/recording-writer.js`
- [Meeting store](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Windows/src/lib/meeting-store.js): `Windows/src/lib/meeting-store.js`
- [Settings store](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Windows/src/lib/settings-store.js): `Windows/src/lib/settings-store.js`
- [Capture recovery](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Windows/src/lib/capture-recovery.js): `Windows/src/lib/capture-recovery.js`
- [Transcript service](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Windows/src/lib/transcript-service.js): `Windows/src/lib/transcript-service.js`
- [Transcript formatter](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Windows/src/lib/transcript-format.js): `Windows/src/lib/transcript-format.js`
- [Renderer bridge](https://github.com/rsaiteja13-lab/meetmemento/blob/main/Windows/src/preload.js): `Windows/src/preload.js`

### Other components

- **User**
- **Zoom meeting**

## Connections

- User → macOS app model: starts or reviews (evidence: `README.md`)
- Zoom meeting → Zoom detector: provides meeting signals (evidence: `README.md`)
- macOS app model → Zoom detector: checks meetings (evidence: `README.md`)
- macOS app model → Capture controller: starts capture (evidence: `Sources/MeetMemento/AppModel.swift`)
- Capture controller → Screen & system audio: starts and stops (evidence: `Sources/MeetMemento/MeetingCaptureController.swift`)
- Capture controller → Microphone capture: starts and stops (evidence: `Sources/MeetMemento/MeetingCaptureController.swift`)
- Screen & system audio → Meeting library: saves capture files (evidence: `README.md`)
- Microphone capture → Meeting library: saves microphone track (evidence: `README.md`)
- macOS app model → Audio chunker: splits transcription work (evidence: `Sources/MeetMemento/AppModel.swift`)
- macOS app model → Speech transcriber: transcribes audio (evidence: `Sources/MeetMemento/AppModel.swift`)
- macOS app model → Transcript formatter: formats transcript (evidence: `Sources/MeetMemento/AppModel.swift`)
- macOS app model → Audio mixer: combines audio tracks (evidence: `Sources/MeetMemento/AppModel.swift`)
- macOS app model → Calendar matcher: matches calendar event (evidence: `Sources/MeetMemento/AppModel.swift`)
- macOS app model → Meeting namer: names meeting (evidence: `Sources/MeetMemento/AppModel.swift`)
- macOS app model → Video validator: validates saved video (evidence: `Sources/MeetMemento/AppModel.swift`)
- macOS app model → Meeting library: manages recordings (evidence: `README.md`)
- User → Main meeting view: uses (evidence: `README.md`)
- Main meeting view → macOS app model: controls recording (evidence: `Sources/MeetMemento/ContentView.swift`)
- Main meeting view → Meeting library: browses recordings (evidence: `Sources/MeetMemento/ContentView.swift`)
- Meeting details → macOS app model: requests meeting actions (evidence: `Sources/MeetMemento/MeetingDetailView.swift`)
- Menu bar → macOS app model: controls capture (evidence: `Sources/MeetMemento/MenuBarView.swift`)
- Onboarding → macOS app model: completes setup (evidence: `Sources/MeetMemento/OnboardingView.swift`)
- Settings → App settings: updates preferences (evidence: `Sources/MeetMemento/SettingsView.swift`)
- macOS app model → Permissions: checks access (evidence: `Sources/MeetMemento/AppModel.swift`)
- App settings → Background guardian manager: installs guardian (evidence: `Sources/MeetMemento/AppSettings.swift`)
- Background guardian manager → Guardian helper: registers helper (evidence: `Sources/MeetMemento/BackgroundGuardianManager.swift`)
- macOS app model → Diagnostics: records diagnostics (evidence: `Sources/MeetMemento/AppModel.swift`)
- User → Electron main process: uses (evidence: `README.md`)
- Electron main process → Zoom detector: checks Zoom meetings (evidence: `Windows/src/main.js`)
- Electron main process → Recording writer: writes capture (evidence: `Windows/src/main.js`)
- Electron main process → Meeting store: manages recordings (evidence: `Windows/src/main.js`)
- Electron main process → Settings store: reads and updates (evidence: `Windows/src/main.js`)
- Electron main process → Capture recovery: uses recovery (evidence: `Windows/src/main.js`)
- Electron main process → Transcript service: requests transcription (evidence: `Windows/src/main.js`)
- Transcript service → Transcript formatter: formats segments (evidence: `Windows/src/lib/transcript-service.js`)
- Meeting store → Recording writer: repairs audio header (evidence: `Windows/src/lib/meeting-store.js`)
- Recording writer → Settings store: writes metadata atomically (evidence: `Windows/src/lib/recording-writer.js`)
- Renderer bridge → Electron main process: bridges renderer IPC
