# nortonfire007/meettrace architecture

> Architecture diagram of the GitHub repository nortonfire007/meettrace, 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/nortonfire007/meettrace
- Repository: https://github.com/nortonfire007/meettrace

## Overview

MeetTrace is a local-first Windows meeting recorder: a desktop user starts a session, microphone and system audio are captured, audio is transcribed locally, and the meeting is saved to a searchable Markdown/JSON archive. The desktop UI also supports browsing meetings and optional Gemini summaries; a Chrome companion shares Google Meet context through an authenticated localhost bridge. The graph reflects documented capabilities and source-index references, but several unsampled UI and bridge relationships are shown only where the README documents them.

Main entry points: [`src/meettrace/ui/controller.py`](https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/ui/controller.py) (Recording controller), [`src/meettrace/ui/app.py`](https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/ui/app.py) (App lifecycle), [`src/meettrace/capture/service.py`](https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/capture/service.py) (Capture service), [`src/meettrace/transcription/service.py`](https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/transcription/service.py) (Transcription service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop experience"]
  node_app["App lifecycle<br/>[app.py]"]
  node_controller["Recording controller<br/>[controller.py]"]
  node_toolbar["Floating toolbar<br/>[toolbar.py]"]
  node_meeting_views["Meeting views"]
  node_settings["Settings view<br/>[settings_view.py]"]
end

subgraph group_audio["Audio capture"]
  node_capture_service["Capture service<br/>[service.py]"]
  node_audio_backend["Windows audio backend<br/>[backend.py]"]
  node_capture_workers["Capture workers<br/>[worker.py]"]
end

subgraph group_transcript["Transcription"]
  node_transcription_service["Transcription service<br/>[service.py]"]
  node_audio_buffer["Audio window buffer<br/>[buffer.py]"]
  node_whisper["Whisper adapter<br/>[whisper_adapter.py]"]
end

subgraph group_archive["Meeting archive"]
  node_artifact_store[("Artifact store<br/>[store.py]")]
  node_markdown["Markdown formatter<br/>[markdown.py]"]
  node_repository["Meeting catalog<br/>[repository.py]"]
  node_summary_worker["Summary worker<br/>[summary_worker.py]"]
end

subgraph group_integrations["Optional integrations"]
  node_summary_provider["Gemini provider<br/>[gemini.py]"]
  node_bridge_server["Local bridge server<br/>[server.py]"]
  node_bridge_adapter["Bridge adapter<br/>[adapter.py]"]
  node_chrome_extension["Chrome extension<br/>[service_worker.js]"]
end

node_user(("Desktop user"))
node_audio_devices(("Windows audio devices"))
node_gemini(("Gemini API"))
node_meet_tab(("Google Meet tab"))

node_user -->|"starts app"| node_app
node_app -->|"initializes"| node_controller
node_app -->|"creates"| node_toolbar
node_app -->|"starts"| node_bridge_server
node_controller -->|"starts capture"| node_capture_service
node_capture_service -->|"uses backend"| node_audio_backend
node_capture_service -->|"starts workers"| node_capture_workers
node_audio_devices -->|"provides audio"| node_audio_backend
node_controller -->|"coordinates"| node_transcription_service
node_transcription_service -->|"buffers chunks"| node_audio_buffer
node_transcription_service -->|"runs inference"| node_whisper
node_controller -->|"persists session"| node_artifact_store
node_controller -->|"updates archive"| node_repository
node_artifact_store -->|"formats notes"| node_markdown
node_meeting_views -->|"browses meetings"| node_repository
node_meeting_views -->|"requests summaries"| node_summary_worker
node_summary_worker -->|"requests summary"| node_summary_provider
node_summary_provider -->|"calls API"| node_gemini
node_meet_tab -->|"supplies context"| node_chrome_extension
node_chrome_extension -->|"synchronizes context"| node_bridge_server
node_settings -->|"pairs token"| node_chrome_extension

click node_app "https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/ui/app.py"
click node_controller "https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/ui/controller.py"
click node_toolbar "https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/ui/toolbar.py"
click node_meeting_views "https://github.com/nortonfire007/meettrace/tree/main/src/meettrace/ui/views"
click node_settings "https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/ui/views/settings_view.py"
click node_capture_service "https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/capture/service.py"
click node_audio_backend "https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/capture/backend.py"
click node_capture_workers "https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/capture/worker.py"
click node_transcription_service "https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/transcription/service.py"
click node_audio_buffer "https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/transcription/buffer.py"
click node_whisper "https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/transcription/whisper_adapter.py"
click node_artifact_store "https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/storage/store.py"
click node_markdown "https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/storage/markdown.py"
click node_repository "https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/storage/repository.py"
click node_summary_worker "https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/ui/summary_worker.py"
click node_summary_provider "https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/summary/gemini.py"
click node_bridge_server "https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/bridge/server.py"
click node_bridge_adapter "https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/bridge/adapter.py"
click node_chrome_extension "https://github.com/nortonfire007/meettrace/blob/main/extension/src/background/service_worker.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_app,node_controller,node_toolbar,node_meeting_views,node_settings,node_user toneBlue
class node_capture_service,node_audio_backend,node_capture_workers toneAmber
class node_transcription_service,node_audio_buffer,node_whisper,node_gemini toneMint
class node_artifact_store,node_markdown,node_repository,node_summary_worker toneRose
class node_summary_provider,node_bridge_server,node_bridge_adapter,node_chrome_extension,node_audio_devices,node_meet_tab toneIndigo
```

## Components

### Desktop experience

- [App lifecycle](https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/ui/app.py): `src/meettrace/ui/app.py`
- [Recording controller](https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/ui/controller.py): `src/meettrace/ui/controller.py`
- [Floating toolbar](https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/ui/toolbar.py): `src/meettrace/ui/toolbar.py`
- [Meeting views](https://github.com/nortonfire007/meettrace/tree/main/src/meettrace/ui/views): `src/meettrace/ui/views`
- [Settings view](https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/ui/views/settings_view.py): `src/meettrace/ui/views/settings_view.py`

### Audio capture

- [Capture service](https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/capture/service.py): `src/meettrace/capture/service.py`
- [Windows audio backend](https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/capture/backend.py): `src/meettrace/capture/backend.py`
- [Capture workers](https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/capture/worker.py): `src/meettrace/capture/worker.py`

### Transcription

- [Transcription service](https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/transcription/service.py): `src/meettrace/transcription/service.py`
- [Audio window buffer](https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/transcription/buffer.py): `src/meettrace/transcription/buffer.py`
- [Whisper adapter](https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/transcription/whisper_adapter.py): `src/meettrace/transcription/whisper_adapter.py`

### Meeting archive

- [Artifact store](https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/storage/store.py): `src/meettrace/storage/store.py`
- [Markdown formatter](https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/storage/markdown.py): `src/meettrace/storage/markdown.py`
- [Meeting catalog](https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/storage/repository.py): `src/meettrace/storage/repository.py`
- [Summary worker](https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/ui/summary_worker.py): `src/meettrace/ui/summary_worker.py`

### Optional integrations

- [Gemini provider](https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/summary/gemini.py): `src/meettrace/summary/gemini.py`
- [Local bridge server](https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/bridge/server.py): `src/meettrace/bridge/server.py`
- [Bridge adapter](https://github.com/nortonfire007/meettrace/blob/main/src/meettrace/bridge/adapter.py): `src/meettrace/bridge/adapter.py`
- [Chrome extension](https://github.com/nortonfire007/meettrace/blob/main/extension/src/background/service_worker.js): `extension/src/background/service_worker.js`

### Other components

- **Desktop user**
- **Windows audio devices**
- **Gemini API**
- **Google Meet tab**

## Connections

- Desktop user → App lifecycle: starts app (evidence: `README.md`)
- App lifecycle → Recording controller: initializes (evidence: `src/meettrace/ui/app.py`)
- App lifecycle → Floating toolbar: creates (evidence: `src/meettrace/ui/app.py`)
- App lifecycle → Local bridge server: starts (evidence: `src/meettrace/ui/app.py`)
- Recording controller → Capture service: starts capture (evidence: `src/meettrace/ui/controller.py`)
- Capture service → Windows audio backend: uses backend (evidence: `src/meettrace/capture/service.py`)
- Capture service → Capture workers: starts workers (evidence: `src/meettrace/capture/service.py`)
- Windows audio devices → Windows audio backend: provides audio (evidence: `README.md`)
- Recording controller → Transcription service: coordinates (evidence: `src/meettrace/ui/controller.py`)
- Transcription service → Audio window buffer: buffers chunks (evidence: `src/meettrace/transcription/service.py`)
- Transcription service → Whisper adapter: runs inference (evidence: `src/meettrace/transcription/service.py`)
- Recording controller → Artifact store: persists session (evidence: `src/meettrace/ui/controller.py`)
- Recording controller → Meeting catalog: updates archive (evidence: `src/meettrace/ui/controller.py`)
- Artifact store → Markdown formatter: formats notes (evidence: `src/meettrace/storage/store.py`)
- Meeting views → Meeting catalog: browses meetings (evidence: `src/meettrace/ui/views/meeting_list_view.py`)
- Meeting views → Summary worker: requests summaries (evidence: `src/meettrace/ui/views/meeting_reader_view.py`)
- Summary worker → Gemini provider: requests summary (evidence: `src/meettrace/ui/summary_worker.py`)
- Gemini provider → Gemini API: calls API (evidence: `README.md`)
- Google Meet tab → Chrome extension: supplies context (evidence: `README.md`)
- Chrome extension → Local bridge server: synchronizes context (evidence: `README.md`)
- Settings view → Chrome extension: pairs token (evidence: `README.md`)
