# les3dev/plume architecture

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

## Overview

Plume is a desktop meeting recorder that captures system and microphone audio, saves a WAV recording, and creates an editable transcript; the README also describes AI summaries. The main evidenced workflow runs from the Tauri backend’s capture commands through audio buffering and WAV writing, then from the meeting context through Deepgram transcription and transcript persistence. The graph includes meeting management, settings, and UI entry points, but their route-level wiring and the summary implementation were not shown, so those relationships are not asserted. Some backend and frontend subsystem links are documented only by the source index.

Main entry points: [`src-tauri/src/commands/start_capture.rs`](https://github.com/les3dev/plume/blob/main/src-tauri/src/commands/start_capture.rs) (Start capture), [`src-tauri/src/lib.rs`](https://github.com/les3dev/plume/blob/main/src-tauri/src/lib.rs) (Tauri app runtime), [`src/lib/meeting/meeting_context.svelte.ts`](https://github.com/les3dev/plume/blob/main/src/lib/meeting/meeting_context.svelte.ts) (Meeting context), [`src-tauri/src/audio/mix.rs`](https://github.com/les3dev/plume/blob/main/src-tauri/src/audio/mix.rs) (Audio mixer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop runtime"]
  node_tauri["Tauri app runtime<br/>[lib.rs]"]
  node_capture_state["Capture state<br/>[capture_state.rs]"]
  node_mic_watcher["Microphone watcher<br/>[mic_watcher.rs]"]
end

subgraph group_capture["Audio capture"]
  node_start_capture["Start capture<br/>[start_capture.rs]"]
  node_stop_capture["Stop capture<br/>[stop_capture.rs]"]
  node_system_capture["System audio engine<br/>[AudioCapture.swift]"]
  node_microphone["Microphone input"]
  node_audio_buffer["Audio buffers<br/>[audio_buffer.rs]"]
  node_audio_mix["Audio mixer<br/>[mix.rs]"]
  node_wav_writer["WAV writer<br/>[write_wav.rs]"]
end

subgraph group_meetings["Meeting workflow"]
  node_meeting_context["Meeting context"]
  node_meetings_context["Meeting collection"]
  node_meeting_files[("Meeting files")]
end

subgraph group_transcription["Transcription"]
  node_transcript_generator["Transcript generator"]
  node_transcript_editor["Transcript editor"]
  node_speaker_identification["Speaker identification"]
  node_ai_summary["AI summaries"]
end

subgraph group_interface["Application interface"]
  node_settings_context["Settings context"]
  node_home_page["Meetings page<br/>[+page.svelte]"]
  node_meeting_page["Meeting page<br/>[+page.svelte]"]
  node_settings_page["Settings page<br/>[+page.svelte]"]
  node_recorder["Recorder interface"]
  node_upload["Audio upload<br/>[Upload.svelte]"]
end

node_user(("Meeting user"))
node_deepgram["Deepgram API"]

node_tauri -->|"manages"| node_capture_state
node_tauri -->|"registers command"| node_start_capture
node_tauri -->|"registers command"| node_stop_capture
node_tauri -->|"starts"| node_mic_watcher
node_start_capture -->|"uses state"| node_capture_state
node_stop_capture -->|"uses state"| node_capture_state
node_start_capture -->|"starts capture"| node_system_capture
node_start_capture -->|"opens input"| node_microphone
node_start_capture -->|"appends samples"| node_audio_buffer
node_start_capture -->|"periodically writes"| node_audio_mix
node_stop_capture -->|"finalizes recording"| node_audio_mix
node_audio_mix -->|"resamples reads"| node_audio_buffer
node_audio_mix -->|"writes frames"| node_wav_writer
node_meeting_context -->|"gets settings"| node_settings_context
node_meeting_context -->|"generates transcript"| node_transcript_generator
node_transcript_generator -->|"sends audio"| node_deepgram
node_meeting_context -->|"reads and writes"| node_meeting_files
node_transcript_editor -->|"uses transcript formats"| node_transcript_generator
node_user -.->|"opens app"| node_home_page
node_user -.->|"views meeting"| node_meeting_page
node_user -.->|"configures app"| node_settings_page
node_user -.->|"records meeting"| node_recorder
node_user -.->|"imports audio"| node_upload
node_user -.->|"requests summary"| node_ai_summary
node_meeting_context -.->|"identifies speakers"| node_speaker_identification

click node_tauri "https://github.com/les3dev/plume/blob/main/src-tauri/src/lib.rs"
click node_capture_state "https://github.com/les3dev/plume/blob/main/src-tauri/src/capture_state.rs"
click node_mic_watcher "https://github.com/les3dev/plume/blob/main/src-tauri/src/mic_watcher.rs"
click node_start_capture "https://github.com/les3dev/plume/blob/main/src-tauri/src/commands/start_capture.rs"
click node_stop_capture "https://github.com/les3dev/plume/blob/main/src-tauri/src/commands/stop_capture.rs"
click node_system_capture "https://github.com/les3dev/plume/blob/main/AudioCapture/Sources/AudioCapture/AudioCapture.swift"
click node_audio_buffer "https://github.com/les3dev/plume/blob/main/src-tauri/src/audio/audio_buffer.rs"
click node_audio_mix "https://github.com/les3dev/plume/blob/main/src-tauri/src/audio/mix.rs"
click node_wav_writer "https://github.com/les3dev/plume/blob/main/src-tauri/src/audio/write_wav.rs"
click node_meeting_context "https://github.com/les3dev/plume/blob/main/src/lib/meeting/meeting_context.svelte.ts"
click node_meetings_context "https://github.com/les3dev/plume/blob/main/src/lib/meetings/meetings_context.svelte.ts"
click node_transcript_generator "https://github.com/les3dev/plume/blob/main/src/lib/transcribe/generate_transcript.ts"
click node_transcript_editor "https://github.com/les3dev/plume/blob/main/src/lib/transcribe/TranscriptEditor.svelte"
click node_speaker_identification "https://github.com/les3dev/plume/blob/main/src/lib/transcribe/identify_speakers.ts"
click node_settings_context "https://github.com/les3dev/plume/blob/main/src/lib/settings/settings_context.svelte.ts"
click node_home_page "https://github.com/les3dev/plume/blob/main/src/routes/%2Bpage.svelte"
click node_meeting_page "https://github.com/les3dev/plume/blob/main/src/routes/meeting/%5Bname%5D/%2Bpage.svelte"
click node_settings_page "https://github.com/les3dev/plume/blob/main/src/routes/settings/%2Bpage.svelte"
click node_recorder "https://github.com/les3dev/plume/blob/main/src/lib/recorder/SuperRecorder.svelte"
click node_upload "https://github.com/les3dev/plume/blob/main/src/lib/upload/Upload.svelte"
click node_ai_summary "https://github.com/les3dev/plume/tree/main/src/lib/transcribe"

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_tauri,node_capture_state,node_mic_watcher,node_user toneBlue
class node_start_capture,node_stop_capture,node_system_capture,node_microphone,node_audio_buffer,node_audio_mix,node_wav_writer toneAmber
class node_meeting_context,node_meetings_context,node_meeting_files,node_deepgram toneMint
class node_transcript_generator,node_transcript_editor,node_speaker_identification,node_ai_summary toneRose
class node_settings_context,node_home_page,node_meeting_page,node_settings_page,node_recorder,node_upload toneIndigo
```

## Components

### Desktop runtime

- [Tauri app runtime](https://github.com/les3dev/plume/blob/main/src-tauri/src/lib.rs): `src-tauri/src/lib.rs`
- [Capture state](https://github.com/les3dev/plume/blob/main/src-tauri/src/capture_state.rs): `src-tauri/src/capture_state.rs`
- [Microphone watcher](https://github.com/les3dev/plume/blob/main/src-tauri/src/mic_watcher.rs): `src-tauri/src/mic_watcher.rs`

### Audio capture

- [Start capture](https://github.com/les3dev/plume/blob/main/src-tauri/src/commands/start_capture.rs): `src-tauri/src/commands/start_capture.rs`
- [Stop capture](https://github.com/les3dev/plume/blob/main/src-tauri/src/commands/stop_capture.rs): `src-tauri/src/commands/stop_capture.rs`
- [System audio engine](https://github.com/les3dev/plume/blob/main/AudioCapture/Sources/AudioCapture/AudioCapture.swift): `AudioCapture/Sources/AudioCapture/AudioCapture.swift`
- **Microphone input**
- [Audio buffers](https://github.com/les3dev/plume/blob/main/src-tauri/src/audio/audio_buffer.rs): `src-tauri/src/audio/audio_buffer.rs`
- [Audio mixer](https://github.com/les3dev/plume/blob/main/src-tauri/src/audio/mix.rs): `src-tauri/src/audio/mix.rs`
- [WAV writer](https://github.com/les3dev/plume/blob/main/src-tauri/src/audio/write_wav.rs): `src-tauri/src/audio/write_wav.rs`

### Meeting workflow

- [Meeting context](https://github.com/les3dev/plume/blob/main/src/lib/meeting/meeting_context.svelte.ts): `src/lib/meeting/meeting_context.svelte.ts`
- [Meeting collection](https://github.com/les3dev/plume/blob/main/src/lib/meetings/meetings_context.svelte.ts): `src/lib/meetings/meetings_context.svelte.ts`
- **Meeting files**

### Transcription

- [Transcript generator](https://github.com/les3dev/plume/blob/main/src/lib/transcribe/generate_transcript.ts): `src/lib/transcribe/generate_transcript.ts`
- [Transcript editor](https://github.com/les3dev/plume/blob/main/src/lib/transcribe/TranscriptEditor.svelte): `src/lib/transcribe/TranscriptEditor.svelte`
- [Speaker identification](https://github.com/les3dev/plume/blob/main/src/lib/transcribe/identify_speakers.ts): `src/lib/transcribe/identify_speakers.ts`
- [AI summaries](https://github.com/les3dev/plume/tree/main/src/lib/transcribe): `src/lib/transcribe`

### Application interface

- [Settings context](https://github.com/les3dev/plume/blob/main/src/lib/settings/settings_context.svelte.ts): `src/lib/settings/settings_context.svelte.ts`
- [Meetings page](https://github.com/les3dev/plume/blob/main/src/routes/%2Bpage.svelte): `src/routes/+page.svelte`
- [Meeting page](https://github.com/les3dev/plume/blob/main/src/routes/meeting/%5Bname%5D/%2Bpage.svelte): `src/routes/meeting/[name]/+page.svelte`
- [Settings page](https://github.com/les3dev/plume/blob/main/src/routes/settings/%2Bpage.svelte): `src/routes/settings/+page.svelte`
- [Recorder interface](https://github.com/les3dev/plume/blob/main/src/lib/recorder/SuperRecorder.svelte): `src/lib/recorder/SuperRecorder.svelte`
- [Audio upload](https://github.com/les3dev/plume/blob/main/src/lib/upload/Upload.svelte): `src/lib/upload/Upload.svelte`

### Other components

- **Meeting user**
- **Deepgram API**

## Connections

- Tauri app runtime → Capture state: manages (evidence: `src-tauri/src/lib.rs`)
- Tauri app runtime → Start capture: registers command (evidence: `src-tauri/src/lib.rs`)
- Tauri app runtime → Stop capture: registers command (evidence: `src-tauri/src/lib.rs`)
- Tauri app runtime → Microphone watcher: starts (evidence: `src-tauri/src/lib.rs`)
- Start capture → Capture state: uses state (evidence: `src-tauri/src/commands/start_capture.rs`)
- Stop capture → Capture state: uses state (evidence: `src-tauri/src/commands/stop_capture.rs`)
- Start capture → System audio engine: starts capture (evidence: `src-tauri/src/commands/start_capture.rs`)
- Start capture → Microphone input: opens input (evidence: `src-tauri/src/commands/start_capture.rs`)
- Start capture → Audio buffers: appends samples (evidence: `src-tauri/src/commands/start_capture.rs`)
- Start capture → Audio mixer: periodically writes (evidence: `src-tauri/src/commands/start_capture.rs`)
- Stop capture → Audio mixer: finalizes recording (evidence: `src-tauri/src/commands/stop_capture.rs`)
- Audio mixer → Audio buffers: resamples reads (evidence: `src-tauri/src/audio/mix.rs`)
- Audio mixer → WAV writer: writes frames (evidence: `src-tauri/src/audio/mix.rs`)
- Meeting context → Settings context: gets settings (evidence: `src/lib/meeting/meeting_context.svelte.ts`)
- Meeting context → Transcript generator: generates transcript (evidence: `src/lib/meeting/meeting_context.svelte.ts`)
- Transcript generator → Deepgram API: sends audio (evidence: `src/lib/transcribe/generate_transcript.ts`)
- Meeting context → Meeting files: reads and writes (evidence: `src/lib/meeting/meeting_context.svelte.ts`)
- Transcript editor → Transcript generator: uses transcript formats (evidence: `src/lib/transcribe/TranscriptEditor.svelte`)
- Meeting user → Meetings page: opens app
- Meeting user → Meeting page: views meeting
- Meeting user → Settings page: configures app
- Meeting user → Recorder interface: records meeting
- Meeting user → Audio upload: imports audio
- Meeting user → AI summaries: requests summary
- Meeting context → Speaker identification: identifies speakers
