How moona3k/macparakeet works
MacParakeet is a local-first macOS voice app for system-wide dictation, media transcription, and meeting capture, with optional networked AI. The main paths take spoken or imported audio through capture and speech recognition to cleaned, saved text; meeting recording additionally supports live notes and later analysis. The graph also preserves calendar automation, editing/library, and CLI capabilities described in the README. Edges use README evidence for documented product flows; source excerpts are incomplete, so finer implementation-level calls are omitted.
Main entry points: STTRuntime.swift Speech engines · MeetingRecordingFlowCoordinator.swift Meeting workflow · MeetingRecordingPanelView.swift Meeting workspace · LLMService.swift AI services
Components 19
App interaction
- Mac app
Sources/MacParakeet/MacParakeetApp.swift - Global hotkeys
Sources/MacParakeet/Hotkey/HotkeyManager.swift - Transcribe UI
Sources/MacParakeet/Views/Transcription/TranscribeView.swift
Audio and speech
- Audio capture
Sources/MacParakeetCore/Audio/MicrophoneEnginePlatform.swift - Meeting capture
Sources/MacParakeetCore/Audio/MeetingAudioCaptureService.swift - Speech engines
Sources/MacParakeetCore/STT/STTRuntime.swift
Transcript and library
- Text cleanup
Sources/MacParakeetCore/TextProcessing/TextProcessingPipeline.swift - Transcription library
Sources/MacParakeet/Views/Transcription/TranscriptionLibraryView.swift - Transcript editor
Sources/MacParakeet/Views/Transcription/TranscriptResultView.swift - Transcription storage
Sources/MacParakeetCore/Database/TranscriptionRepository.swift
Meeting workflows
- Meeting workflow
Sources/MacParakeet/App/MeetingRecordingFlowCoordinator.swift - Calendar triggers
Sources/MacParakeetCore/Calendar/MeetingMonitor.swift - Meeting workspace
Sources/MacParakeet/Views/MeetingRecording/MeetingRecordingPanelView.swift
AI and automation
- AI services
Sources/MacParakeetCore/Services/LLM/LLMService.swift - Ask workspace
Sources/MacParakeet/Views/Ask/AskWorkspaceView.swift - Text transforms
Sources/MacParakeet/App/TransformsCoordinator.swift - CLI commands
Sources/CLI/Commands/TranscribeCommand.swift
Other components
- User
- macOS Calendar
Connections 23
- User → Mac app: uses
README.md - User → Global hotkeys: presses
README.md - Global hotkeys → Audio capture: starts capture
README.md - User → Transcribe UI: imports media
README.md - Transcribe UI → Speech engines: submits audio
README.md - Audio capture → Speech engines: transcribes locally
README.md - Speech engines → Text cleanup: cleans text
README.md - Text cleanup → Transcription storage: saves result
README.md - Transcription storage → Transcription library: provides results
README.md - Transcription library → Transcript editor: opens result
README.md - User → Meeting workspace: records meeting
README.md - Meeting workspace → Meeting workflow: controls recording
README.md - Meeting workflow → Meeting capture: captures audio
README.md - Meeting capture → Speech engines: transcribes locally
README.md - Meeting workflow → Meeting workspace: shows live transcript
README.md - macOS Calendar → Calendar triggers: provides events
README.md - Calendar triggers → Meeting workflow: can auto-start
README.md - Meeting workspace → AI services: requests analysis
README.md - Ask workspace → AI services: asks questions
README.md - User → Text transforms: selects text
README.md - Text transforms → AI services: requests transform
README.md - User → CLI commands: runs command
README.md - CLI commands → Speech engines: transcribes media
README.md