# desukyu/handy architecture

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

- Interactive diagram: https://gitdiagram.com/desukyu/handy
- Repository: https://github.com/desukyu/handy

## Overview

Handy is a cross-platform desktop dictation app: a user triggers recording, speaks, and gets locally transcribed text inserted into the active app. The README documents local VAD, Whisper and Parakeet transcription, shortcut/push-to-talk operation, and paste behavior; the source index supports the backend coordination and post-processing links below. Settings, history, model management, overlays, tray controls, and optional LLM post-processing are distinct product capabilities. Several backend modules were not sampled, so their internal relationships are omitted where the evidence does not establish them.

Main entry points: [`src-tauri/src/actions.rs`](https://github.com/desukyu/handy/blob/main/src-tauri/src/actions.rs) (Transcription actions), [`src-tauri/src/transcription_coordinator.rs`](https://github.com/desukyu/handy/blob/main/src-tauri/src/transcription_coordinator.rs) (Transcription coordinator), [`src-tauri/src/managers/audio.rs`](https://github.com/desukyu/handy/blob/main/src-tauri/src/managers/audio.rs) (Audio manager), [`src/App.tsx`](https://github.com/desukyu/handy/blob/main/src/App.tsx) (React app & settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Capture &amp; control"]
  node_shortcut["Shortcut handler<br/>[handler.rs]"]
  node_coordinator["Transcription coordinator"]
  node_audio["Audio manager<br/>[audio.rs]"]
end

subgraph group_speech["Speech processing"]
  node_audio_toolkit["Audio &amp; VAD"]
  node_actions["Transcription actions<br/>[actions.rs]"]
  node_transcription["Transcription manager<br/>[transcription.rs]"]
  node_models["Model manager<br/>[model.rs]"]
  node_history[("Transcript history<br/>[history.rs]")]
end

subgraph group_delivery["Text &amp; extensions"]
  node_clipboard["Text input<br/>[clipboard.rs]"]
  node_input["System input<br/>[input.rs]"]
  node_llm["LLM post-processing<br/>[llm_client.rs]"]
end

subgraph group_app["Desktop app"]
  node_settings[("Settings store<br/>[settings.rs]")]
  node_commands["Tauri commands"]
  node_bindings["Frontend bindings<br/>[bindings.ts]"]
  node_ui["React app &amp; settings<br/>[App.tsx]"]
  node_settings_store["Settings state<br/>[settingsStore.ts]"]
  node_overlay["Recording overlay<br/>[overlay.rs]"]
  node_tray["System tray<br/>[tray.rs]"]
end

node_user(("User"))
node_target["Active text app"]
node_remote_llm["Configured LLM API"]

node_user -->|"triggers recording"| node_shortcut
node_shortcut -->|"dispatches action"| node_coordinator
node_coordinator -->|"controls recording"| node_audio
node_coordinator -->|"dispatches"| node_actions
node_audio -.->|"captures audio"| node_audio_toolkit
node_actions -->|"transcribes audio"| node_transcription
node_actions -->|"stores transcripts"| node_history
node_actions -->|"requests post-processing"| node_llm
node_actions -->|"uses audio utilities"| node_audio_toolkit
node_transcription -.->|"uses selected model"| node_models
node_user -->|"speaks into"| node_target
node_actions -.->|"delivers transcript"| node_clipboard
node_clipboard -->|"types or pastes"| node_input
node_input -->|"inserts text"| node_target
node_llm -->|"sends optional request"| node_remote_llm
node_ui -->|"invokes commands"| node_bindings
node_bindings -->|"calls backend"| node_commands
node_commands -->|"reads and updates"| node_settings
node_settings_store -->|"loads and updates settings"| node_bindings
node_ui -->|"uses settings state"| node_settings_store
node_user -->|"configures app"| node_ui
node_user -.->|"controls app"| node_tray
node_audio -.->|"updates recording display"| node_overlay

click node_shortcut "https://github.com/desukyu/handy/blob/main/src-tauri/src/shortcut/handler.rs"
click node_coordinator "https://github.com/desukyu/handy/blob/main/src-tauri/src/transcription_coordinator.rs"
click node_audio "https://github.com/desukyu/handy/blob/main/src-tauri/src/managers/audio.rs"
click node_audio_toolkit "https://github.com/desukyu/handy/tree/main/src-tauri/src/audio_toolkit"
click node_actions "https://github.com/desukyu/handy/blob/main/src-tauri/src/actions.rs"
click node_transcription "https://github.com/desukyu/handy/blob/main/src-tauri/src/managers/transcription.rs"
click node_models "https://github.com/desukyu/handy/blob/main/src-tauri/src/managers/model.rs"
click node_history "https://github.com/desukyu/handy/blob/main/src-tauri/src/managers/history.rs"
click node_settings "https://github.com/desukyu/handy/blob/main/src-tauri/src/settings.rs"
click node_commands "https://github.com/desukyu/handy/tree/main/src-tauri/src/commands"
click node_bindings "https://github.com/desukyu/handy/blob/main/src/bindings.ts"
click node_ui "https://github.com/desukyu/handy/blob/main/src/App.tsx"
click node_settings_store "https://github.com/desukyu/handy/blob/main/src/stores/settingsStore.ts"
click node_clipboard "https://github.com/desukyu/handy/blob/main/src-tauri/src/clipboard.rs"
click node_input "https://github.com/desukyu/handy/blob/main/src-tauri/src/input.rs"
click node_llm "https://github.com/desukyu/handy/blob/main/src-tauri/src/llm_client.rs"
click node_overlay "https://github.com/desukyu/handy/blob/main/src-tauri/src/overlay.rs"
click node_tray "https://github.com/desukyu/handy/blob/main/src-tauri/src/tray.rs"

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_shortcut,node_coordinator,node_audio,node_user toneBlue
class node_audio_toolkit,node_actions,node_transcription,node_models,node_history toneAmber
class node_clipboard,node_input,node_llm,node_remote_llm toneMint
class node_settings,node_commands,node_bindings,node_ui,node_settings_store,node_overlay,node_tray toneRose
class node_target toneIndigo
```

## Components

### Capture & control

- [Shortcut handler](https://github.com/desukyu/handy/blob/main/src-tauri/src/shortcut/handler.rs): `src-tauri/src/shortcut/handler.rs`
- [Transcription coordinator](https://github.com/desukyu/handy/blob/main/src-tauri/src/transcription_coordinator.rs): `src-tauri/src/transcription_coordinator.rs`
- [Audio manager](https://github.com/desukyu/handy/blob/main/src-tauri/src/managers/audio.rs): `src-tauri/src/managers/audio.rs`

### Speech processing

- [Audio & VAD](https://github.com/desukyu/handy/tree/main/src-tauri/src/audio_toolkit): `src-tauri/src/audio_toolkit`
- [Transcription actions](https://github.com/desukyu/handy/blob/main/src-tauri/src/actions.rs): `src-tauri/src/actions.rs`
- [Transcription manager](https://github.com/desukyu/handy/blob/main/src-tauri/src/managers/transcription.rs): `src-tauri/src/managers/transcription.rs`
- [Model manager](https://github.com/desukyu/handy/blob/main/src-tauri/src/managers/model.rs): `src-tauri/src/managers/model.rs`
- [Transcript history](https://github.com/desukyu/handy/blob/main/src-tauri/src/managers/history.rs): `src-tauri/src/managers/history.rs`

### Text & extensions

- [Text input](https://github.com/desukyu/handy/blob/main/src-tauri/src/clipboard.rs): `src-tauri/src/clipboard.rs`
- [System input](https://github.com/desukyu/handy/blob/main/src-tauri/src/input.rs): `src-tauri/src/input.rs`
- [LLM post-processing](https://github.com/desukyu/handy/blob/main/src-tauri/src/llm_client.rs): `src-tauri/src/llm_client.rs`

### Desktop app

- [Settings store](https://github.com/desukyu/handy/blob/main/src-tauri/src/settings.rs): `src-tauri/src/settings.rs`
- [Tauri commands](https://github.com/desukyu/handy/tree/main/src-tauri/src/commands): `src-tauri/src/commands`
- [Frontend bindings](https://github.com/desukyu/handy/blob/main/src/bindings.ts): `src/bindings.ts`
- [React app & settings](https://github.com/desukyu/handy/blob/main/src/App.tsx): `src/App.tsx`
- [Settings state](https://github.com/desukyu/handy/blob/main/src/stores/settingsStore.ts): `src/stores/settingsStore.ts`
- [Recording overlay](https://github.com/desukyu/handy/blob/main/src-tauri/src/overlay.rs): `src-tauri/src/overlay.rs`
- [System tray](https://github.com/desukyu/handy/blob/main/src-tauri/src/tray.rs): `src-tauri/src/tray.rs`

### Other components

- **User**
- **Active text app**
- **Configured LLM API**

## Connections

- User → Shortcut handler: triggers recording
- Shortcut handler → Transcription coordinator: dispatches action (evidence: `src-tauri/src/shortcut/handler.rs`)
- Transcription coordinator → Audio manager: controls recording (evidence: `src-tauri/src/transcription_coordinator.rs`)
- Transcription coordinator → Transcription actions: dispatches (evidence: `src-tauri/src/transcription_coordinator.rs`)
- Audio manager → Audio & VAD: captures audio
- Transcription actions → Transcription manager: transcribes audio (evidence: `src-tauri/src/actions.rs`)
- Transcription actions → Transcript history: stores transcripts (evidence: `src-tauri/src/actions.rs`)
- Transcription actions → LLM post-processing: requests post-processing (evidence: `src-tauri/src/actions.rs`)
- Transcription actions → Audio & VAD: uses audio utilities (evidence: `src-tauri/src/actions.rs`)
- Transcription manager → Model manager: uses selected model
- User → Active text app: speaks into
- Transcription actions → Text input: delivers transcript
- Text input → System input: types or pastes (evidence: `src-tauri/src/clipboard.rs`)
- System input → Active text app: inserts text
- LLM post-processing → Configured LLM API: sends optional request (evidence: `src-tauri/src/llm_client.rs`)
- React app & settings → Frontend bindings: invokes commands (evidence: `src/bindings.ts`)
- Frontend bindings → Tauri commands: calls backend (evidence: `src/bindings.ts`)
- Tauri commands → Settings store: reads and updates (evidence: `src-tauri/src/commands/mod.rs`)
- Settings state → Frontend bindings: loads and updates settings (evidence: `src/stores/settingsStore.ts`)
- React app & settings → Settings state: uses settings state (evidence: `src/App.tsx`)
- User → React app & settings: configures app
- User → System tray: controls app
- Audio manager → Recording overlay: updates recording display
