# froloveee3/whisper-dictate architecture

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

## Overview

Whisper Dictate is a Windows system-tray dictation app. Its main workflow is hotkey-triggered recording, transcription, and pasting the result into the focused application; settings, tray controls, autostart, and icon pinning support that workflow. The repository also includes an installer subsystem. Runtime relationships are grounded in the shown main.py calls and README; installer relationships use the shown installer/bootstrap excerpts. Other runtime modules are represented from the README structure and SOURCE INDEX, so unsampled internal calls are omitted.

Main entry points: [`main.py`](https://github.com/froloveee3/whisper-dictate/blob/main/main.py) (App coordinator), [`bootstrap/gpu.py`](https://github.com/froloveee3/whisper-dictate/blob/main/bootstrap/gpu.py) (GPU detection), [`bootstrap/env.py`](https://github.com/froloveee3/whisper-dictate/blob/main/bootstrap/env.py) (Python environment), [`installer.py`](https://github.com/froloveee3/whisper-dictate/blob/main/installer.py) (Installer coordinator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Dictation runtime"]
  node_main["App coordinator<br/>[main.py]"]
  node_audio["Audio capture<br/>[audio.py]"]
  node_transcribe["Whisper lifecycle<br/>[transcribe.py]"]
  node_clipboard["Clipboard and paste<br/>[main.py]"]
  node_config["Configuration<br/>[config.py]"]
end

subgraph group_controls["Tray and settings"]
  node_tray["Tray interface<br/>[tray.py]"]
  node_settings["Settings dialog<br/>[settings.py]"]
  node_pin["Tray pinning<br/>[pin.py]"]
end

subgraph group_windows["Windows integration"]
  node_hotkeys["Global hotkeys<br/>[hotkeys.py]"]
  node_autostart["Autostart<br/>[autostart.py]"]
  node_winutils["Windows utilities<br/>[winutils.py]"]
end

subgraph group_installer["Installer"]
  node_installer_entry["Installer coordinator<br/>[installer.py]"]
  node_install_env["Python environment<br/>[env.py]"]
  node_install_gpu["GPU detection<br/>[gpu.py]"]
  node_deploy["App deployment<br/>[deploy.py]"]
  node_install_paths["Install paths<br/>[paths.py]"]
  node_install_console["Installer output<br/>[console.py]"]
end

node_user(("User"))
node_focused_app["Focused app"]
node_microphone["Microphone"]
node_whisper["Whisper engine"]

node_user -->|"presses"| node_hotkeys
node_hotkeys -->|"dispatches callbacks"| node_main
node_main -->|"registers"| node_hotkeys
node_main -->|"starts and stops"| node_audio
node_microphone -.->|"supplies audio"| node_audio
node_main -->|"preloads and runs"| node_transcribe
node_transcribe -->|"loads and transcribes"| node_whisper
node_main -->|"copies and pastes"| node_clipboard
node_clipboard -->|"pastes text"| node_focused_app
node_main -->|"loads and saves"| node_config
node_main -->|"updates icon and menu"| node_tray
node_main -->|"opens dialog"| node_settings
node_settings -->|"saves settings callback"| node_main
node_main -->|"checks and toggles"| node_autostart
node_main -->|"promotes icon"| node_pin
node_main -->|"configures process"| node_winutils
node_installer_entry -->|"probes and installs"| node_install_env
node_installer_entry -->|"detects and installs torch"| node_install_gpu
node_installer_entry -->|"deploys and launches"| node_deploy
node_install_env -->|"uses paths"| node_install_paths
node_install_gpu -->|"uses package notices"| node_install_env
node_install_gpu -->|"uses pip path"| node_install_paths
node_deploy -->|"uses install paths"| node_install_paths
node_install_env -->|"reports progress"| node_install_console
node_install_gpu -->|"reports progress"| node_install_console
node_deploy -->|"reports deployment"| node_install_console

click node_main "https://github.com/froloveee3/whisper-dictate/blob/main/main.py"
click node_hotkeys "https://github.com/froloveee3/whisper-dictate/blob/main/app/system/hotkeys.py"
click node_audio "https://github.com/froloveee3/whisper-dictate/blob/main/app/core/audio.py"
click node_transcribe "https://github.com/froloveee3/whisper-dictate/blob/main/app/core/transcribe.py"
click node_clipboard "https://github.com/froloveee3/whisper-dictate/blob/main/main.py"
click node_config "https://github.com/froloveee3/whisper-dictate/blob/main/app/config.py"
click node_tray "https://github.com/froloveee3/whisper-dictate/blob/main/app/ui/tray.py"
click node_settings "https://github.com/froloveee3/whisper-dictate/blob/main/app/ui/settings.py"
click node_pin "https://github.com/froloveee3/whisper-dictate/blob/main/app/ui/pin.py"
click node_autostart "https://github.com/froloveee3/whisper-dictate/blob/main/app/system/autostart.py"
click node_winutils "https://github.com/froloveee3/whisper-dictate/blob/main/app/system/winutils.py"
click node_installer_entry "https://github.com/froloveee3/whisper-dictate/blob/main/installer.py"
click node_install_env "https://github.com/froloveee3/whisper-dictate/blob/main/bootstrap/env.py"
click node_install_gpu "https://github.com/froloveee3/whisper-dictate/blob/main/bootstrap/gpu.py"
click node_deploy "https://github.com/froloveee3/whisper-dictate/blob/main/bootstrap/deploy.py"
click node_install_paths "https://github.com/froloveee3/whisper-dictate/blob/main/bootstrap/paths.py"
click node_install_console "https://github.com/froloveee3/whisper-dictate/blob/main/bootstrap/console.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_main,node_audio,node_transcribe,node_clipboard,node_config,node_user toneBlue
class node_tray,node_settings,node_pin toneAmber
class node_hotkeys,node_autostart,node_winutils toneMint
class node_installer_entry,node_install_env,node_install_gpu,node_deploy,node_install_paths,node_install_console toneRose
class node_focused_app,node_microphone,node_whisper toneIndigo
```

## Components

### Dictation runtime

- [App coordinator](https://github.com/froloveee3/whisper-dictate/blob/main/main.py): `main.py`
- [Audio capture](https://github.com/froloveee3/whisper-dictate/blob/main/app/core/audio.py): `app/core/audio.py`
- [Whisper lifecycle](https://github.com/froloveee3/whisper-dictate/blob/main/app/core/transcribe.py): `app/core/transcribe.py`
- [Clipboard and paste](https://github.com/froloveee3/whisper-dictate/blob/main/main.py): `main.py`
- [Configuration](https://github.com/froloveee3/whisper-dictate/blob/main/app/config.py): `app/config.py`

### Tray and settings

- [Tray interface](https://github.com/froloveee3/whisper-dictate/blob/main/app/ui/tray.py): `app/ui/tray.py`
- [Settings dialog](https://github.com/froloveee3/whisper-dictate/blob/main/app/ui/settings.py): `app/ui/settings.py`
- [Tray pinning](https://github.com/froloveee3/whisper-dictate/blob/main/app/ui/pin.py): `app/ui/pin.py`

### Windows integration

- [Global hotkeys](https://github.com/froloveee3/whisper-dictate/blob/main/app/system/hotkeys.py): `app/system/hotkeys.py`
- [Autostart](https://github.com/froloveee3/whisper-dictate/blob/main/app/system/autostart.py): `app/system/autostart.py`
- [Windows utilities](https://github.com/froloveee3/whisper-dictate/blob/main/app/system/winutils.py): `app/system/winutils.py`

### Installer

- [Installer coordinator](https://github.com/froloveee3/whisper-dictate/blob/main/installer.py): `installer.py`
- [Python environment](https://github.com/froloveee3/whisper-dictate/blob/main/bootstrap/env.py): `bootstrap/env.py`
- [GPU detection](https://github.com/froloveee3/whisper-dictate/blob/main/bootstrap/gpu.py): `bootstrap/gpu.py`
- [App deployment](https://github.com/froloveee3/whisper-dictate/blob/main/bootstrap/deploy.py): `bootstrap/deploy.py`
- [Install paths](https://github.com/froloveee3/whisper-dictate/blob/main/bootstrap/paths.py): `bootstrap/paths.py`
- [Installer output](https://github.com/froloveee3/whisper-dictate/blob/main/bootstrap/console.py): `bootstrap/console.py`

### Other components

- **User**
- **Focused app**
- **Microphone**
- **Whisper engine**

## Connections

- User → Global hotkeys: presses (evidence: `README.md`)
- Global hotkeys → App coordinator: dispatches callbacks (evidence: `main.py`)
- App coordinator → Global hotkeys: registers (evidence: `main.py`)
- App coordinator → Audio capture: starts and stops (evidence: `main.py`)
- Microphone → Audio capture: supplies audio
- App coordinator → Whisper lifecycle: preloads and runs (evidence: `main.py`)
- Whisper lifecycle → Whisper engine: loads and transcribes (evidence: `README.md`)
- App coordinator → Clipboard and paste: copies and pastes (evidence: `main.py`)
- Clipboard and paste → Focused app: pastes text (evidence: `README.md`)
- App coordinator → Configuration: loads and saves (evidence: `main.py`)
- App coordinator → Tray interface: updates icon and menu (evidence: `main.py`)
- App coordinator → Settings dialog: opens dialog (evidence: `main.py`)
- Settings dialog → App coordinator: saves settings callback (evidence: `main.py`)
- App coordinator → Autostart: checks and toggles (evidence: `main.py`)
- App coordinator → Tray pinning: promotes icon (evidence: `main.py`)
- App coordinator → Windows utilities: configures process (evidence: `main.py`)
- Installer coordinator → Python environment: probes and installs (evidence: `installer.py`)
- Installer coordinator → GPU detection: detects and installs torch (evidence: `installer.py`)
- Installer coordinator → App deployment: deploys and launches (evidence: `installer.py`)
- Python environment → Install paths: uses paths (evidence: `bootstrap/env.py`)
- GPU detection → Python environment: uses package notices (evidence: `bootstrap/gpu.py`)
- GPU detection → Install paths: uses pip path (evidence: `bootstrap/gpu.py`)
- App deployment → Install paths: uses install paths (evidence: `bootstrap/deploy.py`)
- Python environment → Installer output: reports progress (evidence: `bootstrap/env.py`)
- GPU detection → Installer output: reports progress (evidence: `bootstrap/gpu.py`)
- App deployment → Installer output: reports deployment (evidence: `bootstrap/deploy.py`)
