# akirasane/scribsalmon architecture

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

- Interactive diagram: https://gitdiagram.com/akirasane/scribsalmon
- Repository: https://github.com/akirasane/scribsalmon

## Overview

ScribSalmon is a Windows meeting-notes app. The user creates a note, captures system audio and/or microphone audio, transcribes live or after recording, edits or refines the transcript, checks uncertain words, and generates an editable summary for export. The React interface communicates through a pywebview bridge to a Python controller, which coordinates audio, transcription, summaries, notes, settings, and updates. The README documents major capabilities and integrations; unsampled implementation details are represented only where documented.

Main entry points: [`app/core.py`](https://github.com/akirasane/scribsalmon/blob/main/app/core.py) (App controller), [`web/src/App.tsx`](https://github.com/akirasane/scribsalmon/blob/main/web/src/App.tsx) (App interface), [`web/src/components/NoteView.tsx`](https://github.com/akirasane/scribsalmon/blob/main/web/src/components/NoteView.tsx) (Note editor), [`web/src/components/ControlBar.tsx`](https://github.com/akirasane/scribsalmon/blob/main/web/src/components/ControlBar.tsx) (Recording controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop interface"]
  node_shell["Desktop host<br/>[main.py]"]
  node_appui["App interface<br/>[App.tsx]"]
  node_noteview["Note editor<br/>[NoteView.tsx]"]
  node_controlbar["Recording controls<br/>[ControlBar.tsx]"]
  node_sidebar["Notes list<br/>[Sidebar.tsx]"]
  node_settingsui["Settings panel<br/>[SettingsModal.tsx]"]
  node_reviewui["Word review<br/>[ReviewModal.tsx]"]
  node_updateui["Update banner<br/>[UpdateBanner.tsx]"]
end

subgraph group_control["App control"]
  node_bridge["Webview bridge<br/>[bridge.ts]"]
  node_api["Webview API<br/>[api.py]"]
  node_core["App controller<br/>[core.py]"]
  node_updater["Update manager<br/>[updater.py]"]
end

subgraph group_meeting["Meeting processing"]
  node_audio["Audio capture<br/>[audio.py]"]
  node_transcribe["Transcription<br/>[transcribe.py]"]
  node_summary["Summary and review<br/>[summarize.py]"]
end

subgraph group_data["Notes and settings"]
  node_notes["Note storage<br/>[sessions.py]"]
  node_settings["Settings storage<br/>[settings.py]"]
  node_dpapi["Secret encryption<br/>[dpapi.py]"]
end

subgraph group_services["External services"]
  node_whisper["Whisper services"]
  node_claude["Claude services"]
end

node_user(("Meeting user"))
node_useraudio(("Audio sources"))
node_github["GitHub releases"]

node_user -->|"uses"| node_appui
node_shell -->|"exposes"| node_api
node_appui -->|"calls"| node_bridge
node_api -->|"delegates"| node_core
node_appui -->|"renders"| node_noteview
node_appui -->|"renders"| node_sidebar
node_appui -->|"renders"| node_settingsui
node_appui -->|"renders"| node_reviewui
node_appui -->|"renders"| node_updateui
node_noteview -->|"renders"| node_controlbar
node_useraudio -->|"supplies audio"| node_audio
node_core -->|"captures"| node_audio
node_core -->|"transcribes"| node_transcribe
node_core -->|"summarizes and reviews"| node_summary
node_core -->|"reads and writes"| node_notes
node_core -->|"loads and updates"| node_settings
node_settings -->|"encrypts secrets"| node_dpapi
node_transcribe -->|"uses API or models"| node_whisper
node_summary -->|"uses CLI or API"| node_claude
node_core -->|"checks and installs"| node_updater
node_updater -->|"checks releases"| node_github
node_settingsui -->|"changes settings"| node_core
node_controlbar -->|"starts recording"| node_core
node_noteview -->|"requests note tasks"| node_core
node_reviewui -->|"applies corrections"| node_core

click node_shell "https://github.com/akirasane/scribsalmon/blob/main/main.py"
click node_appui "https://github.com/akirasane/scribsalmon/blob/main/web/src/App.tsx"
click node_noteview "https://github.com/akirasane/scribsalmon/blob/main/web/src/components/NoteView.tsx"
click node_controlbar "https://github.com/akirasane/scribsalmon/blob/main/web/src/components/ControlBar.tsx"
click node_sidebar "https://github.com/akirasane/scribsalmon/blob/main/web/src/components/Sidebar.tsx"
click node_settingsui "https://github.com/akirasane/scribsalmon/blob/main/web/src/components/SettingsModal.tsx"
click node_reviewui "https://github.com/akirasane/scribsalmon/blob/main/web/src/components/ReviewModal.tsx"
click node_updateui "https://github.com/akirasane/scribsalmon/blob/main/web/src/components/UpdateBanner.tsx"
click node_bridge "https://github.com/akirasane/scribsalmon/blob/main/web/src/bridge.ts"
click node_api "https://github.com/akirasane/scribsalmon/blob/main/app/api.py"
click node_core "https://github.com/akirasane/scribsalmon/blob/main/app/core.py"
click node_audio "https://github.com/akirasane/scribsalmon/blob/main/app/audio.py"
click node_transcribe "https://github.com/akirasane/scribsalmon/blob/main/app/transcribe.py"
click node_summary "https://github.com/akirasane/scribsalmon/blob/main/app/summarize.py"
click node_notes "https://github.com/akirasane/scribsalmon/blob/main/app/sessions.py"
click node_settings "https://github.com/akirasane/scribsalmon/blob/main/app/settings.py"
click node_dpapi "https://github.com/akirasane/scribsalmon/blob/main/app/dpapi.py"
click node_updater "https://github.com/akirasane/scribsalmon/blob/main/app/updater.py"

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_shell,node_appui,node_noteview,node_controlbar,node_sidebar,node_settingsui,node_reviewui,node_updateui,node_user toneBlue
class node_bridge,node_api,node_core,node_updater toneAmber
class node_audio,node_transcribe,node_summary toneMint
class node_notes,node_settings,node_dpapi toneRose
class node_whisper,node_claude,node_useraudio,node_github toneIndigo
```

## Components

### Desktop interface

- [Desktop host](https://github.com/akirasane/scribsalmon/blob/main/main.py): `main.py`
- [App interface](https://github.com/akirasane/scribsalmon/blob/main/web/src/App.tsx): `web/src/App.tsx`
- [Note editor](https://github.com/akirasane/scribsalmon/blob/main/web/src/components/NoteView.tsx): `web/src/components/NoteView.tsx`
- [Recording controls](https://github.com/akirasane/scribsalmon/blob/main/web/src/components/ControlBar.tsx): `web/src/components/ControlBar.tsx`
- [Notes list](https://github.com/akirasane/scribsalmon/blob/main/web/src/components/Sidebar.tsx): `web/src/components/Sidebar.tsx`
- [Settings panel](https://github.com/akirasane/scribsalmon/blob/main/web/src/components/SettingsModal.tsx): `web/src/components/SettingsModal.tsx`
- [Word review](https://github.com/akirasane/scribsalmon/blob/main/web/src/components/ReviewModal.tsx): `web/src/components/ReviewModal.tsx`
- [Update banner](https://github.com/akirasane/scribsalmon/blob/main/web/src/components/UpdateBanner.tsx): `web/src/components/UpdateBanner.tsx`

### App control

- [Webview bridge](https://github.com/akirasane/scribsalmon/blob/main/web/src/bridge.ts): `web/src/bridge.ts`
- [Webview API](https://github.com/akirasane/scribsalmon/blob/main/app/api.py): `app/api.py`
- [App controller](https://github.com/akirasane/scribsalmon/blob/main/app/core.py): `app/core.py`
- [Update manager](https://github.com/akirasane/scribsalmon/blob/main/app/updater.py): `app/updater.py`

### Meeting processing

- [Audio capture](https://github.com/akirasane/scribsalmon/blob/main/app/audio.py): `app/audio.py`
- [Transcription](https://github.com/akirasane/scribsalmon/blob/main/app/transcribe.py): `app/transcribe.py`
- [Summary and review](https://github.com/akirasane/scribsalmon/blob/main/app/summarize.py): `app/summarize.py`

### Notes and settings

- [Note storage](https://github.com/akirasane/scribsalmon/blob/main/app/sessions.py): `app/sessions.py`
- [Settings storage](https://github.com/akirasane/scribsalmon/blob/main/app/settings.py): `app/settings.py`
- [Secret encryption](https://github.com/akirasane/scribsalmon/blob/main/app/dpapi.py): `app/dpapi.py`

### External services

- **Whisper services**
- **Claude services**

### Other components

- **Meeting user**
- **Audio sources**
- **GitHub releases**

## Connections

- Meeting user → App interface: uses (evidence: `README.md`)
- Desktop host → Webview API: exposes (evidence: `main.py`)
- App interface → Webview bridge: calls (evidence: `web/src/App.tsx`)
- Webview API → App controller: delegates (evidence: `app/api.py`)
- App interface → Note editor: renders (evidence: `web/src/App.tsx`)
- App interface → Notes list: renders (evidence: `web/src/App.tsx`)
- App interface → Settings panel: renders (evidence: `web/src/App.tsx`)
- App interface → Word review: renders (evidence: `web/src/App.tsx`)
- App interface → Update banner: renders (evidence: `web/src/App.tsx`)
- Note editor → Recording controls: renders (evidence: `web/src/components/NoteView.tsx`)
- Audio sources → Audio capture: supplies audio (evidence: `README.md`)
- App controller → Audio capture: captures (evidence: `app/core.py`)
- App controller → Transcription: transcribes (evidence: `app/core.py`)
- App controller → Summary and review: summarizes and reviews (evidence: `app/core.py`)
- App controller → Note storage: reads and writes (evidence: `app/core.py`)
- App controller → Settings storage: loads and updates (evidence: `app/core.py`)
- Settings storage → Secret encryption: encrypts secrets (evidence: `app/settings.py`)
- Transcription → Whisper services: uses API or models (evidence: `README.md`)
- Summary and review → Claude services: uses CLI or API (evidence: `README.md`)
- App controller → Update manager: checks and installs (evidence: `app/core.py`)
- Update manager → GitHub releases: checks releases (evidence: `README.md`)
- Settings panel → App controller: changes settings (evidence: `README.md`)
- Recording controls → App controller: starts recording (evidence: `README.md`)
- Note editor → App controller: requests note tasks (evidence: `README.md`)
- Word review → App controller: applies corrections (evidence: `README.md`)
