# noid1290/paddy architecture

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

- Interactive diagram: https://gitdiagram.com/noid1290/paddy
- Repository: https://github.com/noid1290/paddy

## Overview

PaDDY is a Windows pad-based audio recorder. Users choose a microphone, system, or app-specific source and capture with AutoVAD or a rolling key buffer; clips are then organized, previewed, trimmed, and replayed. The graph also shows effects, metering, speech recognition, settings, and plugin support. Several relationships are evidenced by the README or SOURCE INDEX references; unsampled implementations are represented only where their paths are supported, and uncertain links are omitted.

Main entry points: [`Views/MainWindow.xaml.cs`](https://github.com/noid1290/paddy/blob/main/Views/MainWindow.xaml.cs) (Pad workspace), [`Services/AudioCaptureService.cs`](https://github.com/noid1290/paddy/blob/main/Services/AudioCaptureService.cs) (Capture service), [`AudioProcessor/StreamingRecorderFactory.cs`](https://github.com/noid1290/paddy/blob/main/AudioProcessor/StreamingRecorderFactory.cs) (Recorder factory), [`EffectProcessor/EffectChainFactory.cs`](https://github.com/noid1290/paddy/blob/main/EffectProcessor/EffectChainFactory.cs) (Effect chains)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and pads"]
  node_main["Pad workspace<br/>[MainWindow.xaml.cs]"]
  node_editor["Clip editor"]
  node_settings_ui["Settings window"]
  node_pads["Pad pages<br/>[PadPage.cs]"]
  node_record_store[("Clip store<br/>[RecordingStore.cs]")]
end

subgraph group_capture["Audio capture"]
  node_capture_service["Capture service"]
  node_audio_source(("Audio devices"))
  node_recorder_factory["Recorder factory"]
  node_recorders["Format recorders"]
end

subgraph group_audio["Audio processing"]
  node_effect_factory["Effect chains"]
  node_vst_manager["VST plugins"]
  node_effect_settings["Effect settings"]
  node_speech["Speech recognition"]
  node_playback["Audio playback"]
  node_meter["Playback metering"]
end

subgraph group_support["Settings and services"]
  node_settings["App settings<br/>[AppSettings.cs]"]
  node_theme["Theme manager<br/>[ThemeManager.cs]"]
  node_localization["Localization"]
  node_hotkeys["Global hotkeys"]
end

node_user(("User"))

node_user -->|"operates"| node_main
node_main -->|"starts capture"| node_capture_service
node_audio_source -->|"provides audio"| node_capture_service
node_capture_service -->|"creates recorder"| node_recorder_factory
node_recorder_factory -.->|"selects format"| node_recorders
node_capture_service -->|"saves clips"| node_record_store
node_main -->|"manages clips"| node_record_store
node_main -->|"uses pages"| node_pads
node_main -.->|"opens editor"| node_editor
node_main -.->|"previews clips"| node_playback
node_main -->|"builds effects"| node_effect_factory
node_effect_factory -.->|"loads plugins"| node_vst_manager
node_main -->|"loads effects"| node_effect_settings
node_main -->|"requests transcription"| node_speech
node_playback -.->|"feeds playback"| node_meter
node_main -->|"registers hotkeys"| node_hotkeys
node_settings_ui -.->|"edits settings"| node_settings
node_main -->|"reads settings"| node_settings
node_main -->|"applies theme"| node_theme
node_main -->|"uses language"| node_localization

click node_main "https://github.com/noid1290/paddy/blob/main/Views/MainWindow.xaml.cs"
click node_editor "https://github.com/noid1290/paddy/blob/main/Views/AudioEditorWindow.xaml.cs"
click node_settings_ui "https://github.com/noid1290/paddy/blob/main/Views/SettingsWindow.xaml.cs"
click node_pads "https://github.com/noid1290/paddy/blob/main/Models/PadPage.cs"
click node_capture_service "https://github.com/noid1290/paddy/blob/main/Services/AudioCaptureService.cs"
click node_recorder_factory "https://github.com/noid1290/paddy/blob/main/AudioProcessor/StreamingRecorderFactory.cs"
click node_recorders "https://github.com/noid1290/paddy/tree/main/AudioProcessor"
click node_record_store "https://github.com/noid1290/paddy/blob/main/Services/RecordingStore.cs"
click node_effect_factory "https://github.com/noid1290/paddy/blob/main/EffectProcessor/EffectChainFactory.cs"
click node_vst_manager "https://github.com/noid1290/paddy/blob/main/EffectProcessor/VstPluginManager.cs"
click node_effect_settings "https://github.com/noid1290/paddy/blob/main/Helpers/EffectSettingsManager.cs"
click node_speech "https://github.com/noid1290/paddy/blob/main/Services/SpeechRecognitionService.cs"
click node_playback "https://github.com/noid1290/paddy/blob/main/AudioProcessor/AudioPlayerFactory.cs"
click node_meter "https://github.com/noid1290/paddy/blob/main/AudioProcessor/PlaybackMeterProvider.cs"
click node_settings "https://github.com/noid1290/paddy/blob/main/Models/AppSettings.cs"
click node_theme "https://github.com/noid1290/paddy/blob/main/Helpers/ThemeManager.cs"
click node_localization "https://github.com/noid1290/paddy/blob/main/Services/LocalizationManager.cs"
click node_hotkeys "https://github.com/noid1290/paddy/blob/main/Services/GlobalHotkeyService.cs"

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_editor,node_settings_ui,node_pads,node_record_store,node_user toneBlue
class node_capture_service,node_audio_source,node_recorder_factory,node_recorders toneAmber
class node_effect_factory,node_vst_manager,node_effect_settings,node_speech,node_playback,node_meter toneMint
class node_settings,node_theme,node_localization,node_hotkeys toneRose
```

## Components

### App and pads

- [Pad workspace](https://github.com/noid1290/paddy/blob/main/Views/MainWindow.xaml.cs): `Views/MainWindow.xaml.cs`
- [Clip editor](https://github.com/noid1290/paddy/blob/main/Views/AudioEditorWindow.xaml.cs): `Views/AudioEditorWindow.xaml.cs`
- [Settings window](https://github.com/noid1290/paddy/blob/main/Views/SettingsWindow.xaml.cs): `Views/SettingsWindow.xaml.cs`
- [Pad pages](https://github.com/noid1290/paddy/blob/main/Models/PadPage.cs): `Models/PadPage.cs`
- [Clip store](https://github.com/noid1290/paddy/blob/main/Services/RecordingStore.cs): `Services/RecordingStore.cs`

### Audio capture

- [Capture service](https://github.com/noid1290/paddy/blob/main/Services/AudioCaptureService.cs): `Services/AudioCaptureService.cs`
- **Audio devices**
- [Recorder factory](https://github.com/noid1290/paddy/blob/main/AudioProcessor/StreamingRecorderFactory.cs): `AudioProcessor/StreamingRecorderFactory.cs`
- [Format recorders](https://github.com/noid1290/paddy/tree/main/AudioProcessor): `AudioProcessor`

### Audio processing

- [Effect chains](https://github.com/noid1290/paddy/blob/main/EffectProcessor/EffectChainFactory.cs): `EffectProcessor/EffectChainFactory.cs`
- [VST plugins](https://github.com/noid1290/paddy/blob/main/EffectProcessor/VstPluginManager.cs): `EffectProcessor/VstPluginManager.cs`
- [Effect settings](https://github.com/noid1290/paddy/blob/main/Helpers/EffectSettingsManager.cs): `Helpers/EffectSettingsManager.cs`
- [Speech recognition](https://github.com/noid1290/paddy/blob/main/Services/SpeechRecognitionService.cs): `Services/SpeechRecognitionService.cs`
- [Audio playback](https://github.com/noid1290/paddy/blob/main/AudioProcessor/AudioPlayerFactory.cs): `AudioProcessor/AudioPlayerFactory.cs`
- [Playback metering](https://github.com/noid1290/paddy/blob/main/AudioProcessor/PlaybackMeterProvider.cs): `AudioProcessor/PlaybackMeterProvider.cs`

### Settings and services

- [App settings](https://github.com/noid1290/paddy/blob/main/Models/AppSettings.cs): `Models/AppSettings.cs`
- [Theme manager](https://github.com/noid1290/paddy/blob/main/Helpers/ThemeManager.cs): `Helpers/ThemeManager.cs`
- [Localization](https://github.com/noid1290/paddy/blob/main/Services/LocalizationManager.cs): `Services/LocalizationManager.cs`
- [Global hotkeys](https://github.com/noid1290/paddy/blob/main/Services/GlobalHotkeyService.cs): `Services/GlobalHotkeyService.cs`

### Other components

- **User**

## Connections

- User → Pad workspace: operates (evidence: `README.md`)
- Pad workspace → Capture service: starts capture (evidence: `Views/MainWindow.xaml.cs`)
- Audio devices → Capture service: provides audio (evidence: `Services/AudioCaptureService.cs`)
- Capture service → Recorder factory: creates recorder (evidence: `Services/AudioCaptureService.cs`)
- Recorder factory → Format recorders: selects format
- Capture service → Clip store: saves clips (evidence: `Services/AudioCaptureService.cs`)
- Pad workspace → Clip store: manages clips (evidence: `Views/MainWindow.xaml.cs`)
- Pad workspace → Pad pages: uses pages (evidence: `Views/MainWindow.xaml.cs`)
- Pad workspace → Clip editor: opens editor
- Pad workspace → Audio playback: previews clips
- Pad workspace → Effect chains: builds effects (evidence: `Views/MainWindow.xaml.cs`)
- Effect chains → VST plugins: loads plugins
- Pad workspace → Effect settings: loads effects (evidence: `Views/MainWindow.xaml.cs`)
- Pad workspace → Speech recognition: requests transcription (evidence: `Views/MainWindow.xaml.cs`)
- Audio playback → Playback metering: feeds playback
- Pad workspace → Global hotkeys: registers hotkeys (evidence: `Views/MainWindow.xaml.cs`)
- Settings window → App settings: edits settings
- Pad workspace → App settings: reads settings (evidence: `Views/MainWindow.xaml.cs`)
- Pad workspace → Theme manager: applies theme (evidence: `Views/MainWindow.xaml.cs`)
- Pad workspace → Localization: uses language (evidence: `Views/MainWindow.xaml.cs`)
