# OpenSuperWhisper | Starmel | Knowledge Base | Instagit

macOS dictation app

GitHub Stars: 1.8k

Repository: https://github.com/Starmel/OpenSuperWhisper

---

## Articles

### [How to Contribute Code to OpenSuperWhisper: A Complete Developer's Guide](/Starmel/OpenSuperWhisper/how-to-contribute-code-to-opensuperwhisper)

Learn how to contribute code to OpenSuperWhisper with this complete developer's guide. Fork the repo, implement changes, test with run.sh, and submit your pull request.

- Tags: how-to-guide
- Published: 2026-07-07

### [OpenSuperWhisper Audio Formats: Supported File Types and Conversion Guide](/Starmel/OpenSuperWhisper/supported-audio-formats-by-opensuperwhisper)

Discover OpenSuperWhisper supported audio formats like WAV, MP3, and M4A. Learn how it automatically converts files for seamless transcription and get our conversion guide.

- Tags: api-reference
- Published: 2026-07-07

### [OpenSuperWhisper Example Usage: Complete Guide to Real-Time Transcription](/Starmel/OpenSuperWhisper/where-to-find-example-usage-of-opensuperwhisper)

Explore OpenSuperWhisper example usage with this comprehensive guide. Learn instant recording, batch processing, and Swift API integration for real-time transcription.

- Tags: deep-dive
- Published: 2026-07-07

### [OpenSuperWhisper License Details: MIT License Terms and Compliance Guide](/Starmel/OpenSuperWhisper/license-details-for-opensuperwhisper)

Explore the OpenSuperWhisper MIT License terms. Learn how to freely use, modify, and distribute this software in your projects while ensuring compliance for the Starmel/OpenSuperWhisper repository.

- Tags: api-reference
- Published: 2026-07-07

### [How to Upgrade OpenSuperWhisper to the Latest Version: 3 Methods Explained](/Starmel/OpenSuperWhisper/upgrade-opensuperwhisper-to-latest-version)

Upgrade OpenSuperWhisper to the latest version with Homebrew or by building from the latest commit. Learn the easiest methods for stable or custom builds.

- Tags: how-to-guide
- Published: 2026-07-07

### [Contributing to OpenSuperWhisper: Guidelines and Workflow](/Starmel/OpenSuperWhisper/contributing-guidelines-for-opensuperwhisper)

Learn how to contribute to OpenSuperWhisper. Follow our guidelines for submitting issues, feature branches, and pull requests to the Starmel/OpenSuperWhisper repository.

- Tags: how-to-guide
- Published: 2026-07-07

### [Can OpenSuperWhisper Handle Noisy Audio? Technical Architecture Explained](/Starmel/OpenSuperWhisper/can-opensuperwhisper-handle-noisy-audio)

Discover how OpenSuperWhisper tackles noisy audio using advanced filtering, dynamic decoding, and signal normalization. Learn its technical architecture for clear speech extraction.

- Tags: technical-architecture
- Published: 2026-07-07

### [OpenSuperWhisper vs Whisper: Understanding the Key Differences](/Starmel/OpenSuperWhisper/difference-between-opensuperwhisper-and-whisper)

Discover OpenSuperWhisper vs Whisper. Learn how OpenSuperWhisper enhances the Whisper C++ engine with a native macOS UI and real-time transcription for a superior audio processing workflow.

- Tags: comparison
- Published: 2026-07-07

### [How to Set Up OpenSuperWhisper for Docker Deployment](/Starmel/OpenSuperWhisper/setup-opensuperwhisper-for-docker-deployment)

Deploy OpenSuperWhisper on Linux using Docker. Learn to build the C++ inference engine and Python wrapper in a multi-stage Docker image for headless operation. Get it running fast.

- Tags: how-to-guide
- Published: 2026-07-07

### [Does OpenSuperWhisper Offer an API?](/Starmel/OpenSuperWhisper/does-opensuperwhisper-offer-api)

Explore the OpenSuperWhisper API. Discover how to use its internal Swift API for programmatic transcription within your macOS applications.

- Tags: api-reference
- Published: 2026-07-07

### [How to Batch Process Audio Files with OpenSuperWhisper: Complete Guide](/Starmel/OpenSuperWhisper/batch-process-audio-files-with-opensuperwhisper)

Batch process audio files efficiently with OpenSuperWhisper. Learn to use its powerful transcription queue for seamless, responsive audio processing via drag-and-drop, menu, or API.

- Tags: how-to-guide
- Published: 2026-07-07

### [What Are the Default Models Used by OpenSuperWhisper?](/Starmel/OpenSuperWhisper/default-models-used-by-opensuperwhisper)

Discover the default models in OpenSuperWhisper including ggml-tiny.en.bin, Turbo V3 models, and internal agent LLMs. Learn about automatic model setup.

- Tags: getting-started
- Published: 2026-07-07

### [How to Troubleshoot OpenSuperWhisper Installation Errors on macOS](/Starmel/OpenSuperWhisper/troubleshoot-opensuperwhisper-installation-errors)

Fix OpenSuperWhisper macOS installation errors by checking Xcode command line tools Homebrew libraries and build scripts Resolve common dependency Rust toolchain and code signing issues

- Tags: how-to-guide
- Published: 2026-07-07

### [OpenSuperWhisper Architecture: A Deep Dive into the macOS Real-Time Transcription Engine](/Starmel/OpenSuperWhisper/what-is-the-architecture-of-opensuperwhisper)

Explore the OpenSuperWhisper architecture, a modular Swift engine for macOS real-time transcription. Understand its UI, audio capture, and transcription engine separation via protocol-oriented design.

- Tags: architecture
- Published: 2026-07-07

### [How to Fine-Tune OpenSuperWhisper Models: A Complete Developer Guide](/Starmel/OpenSuperWhisper/how-to-fine-tune-opensuperwhisper-models)

Learn how to fine-tune OpenSuperWhisper models. This guide shows how to load compatible GGML bin files without source code changes. Enhance your speech recognition models today.

- Tags: how-to-guide
- Published: 2026-07-07

### [What Languages Does OpenSuperWhisper Support? Complete Language Guide and Technical Reference](/Starmel/OpenSuperWhisper/what-languages-does-opensuperwhisper-support)

Discover the full range of languages OpenSuperWhisper supports. Explore its capabilities with Whisper, Parakeet v3, and Parakeet v2 in our comprehensive language guide.

- Tags: api-reference
- Published: 2026-07-07

### [Does OpenSuperWhisper Support Real-Time Audio Transcription? A Technical Deep Dive](/Starmel/OpenSuperWhisper/can-opensuperwhisper-transcribe-real-time-audio)

Discover if OpenSuperWhisper supports real-time audio transcription. Learn how it continuously captures live audio and delivers fast text updates for seamless voice interaction.

- Tags: deep-dive
- Published: 2026-07-07

### [How to Use OpenSuperWhisper for Audio Transcription: A Complete Guide](/Starmel/OpenSuperWhisper/how-to-use-opensuperwhisper-for-audio-transcription)

Learn how to use OpenSuperWhisper for audio transcription on macOS. This guide covers real-time capture, format conversion, and on-device transcription with Whisper or FluidAudio.

- Tags: how-to-guide
- Published: 2026-07-07

### [OpenSuperWhisper System Requirements: Apple Silicon macOS Only](/Starmel/OpenSuperWhisper/opensuperwhisper-system-requirements)

Discover the system requirements for OpenSuperWhisper. Learn that Apple Silicon Macs with macOS 12 Monterey+ are required; Intel Macs and Windows PCs are not supported. Get started now.

- Tags: system-requirements
- Published: 2026-07-07

### [What Are WhisperAheads and How They Enable Accurate Token Timestamps in OpenSuperWhisper](/Starmel/OpenSuperWhisper/what-are-whisperaheads-and-how-are-they-used-in-the-transcription-process)

Discover WhisperAheads, Swift wrappers that sync Whisper C attention heads for accurate token timestamps via dynamic time warping in OpenSuperWhisper.

- Tags: deep-dive
- Published: 2026-07-07

### [How Asian Language Autocorrect Is Integrated in OpenSuperWhisper](/Starmel/OpenSuperWhisper/how-is-asian-language-autocorrect-integrated)

Discover how OpenSuperWhisper integrates Asian language autocorrect using a Swift wrapper and a native C library to enhance Chinese, Japanese, and Korean transcription with improved punctuation and spacing.

- Tags: internals
- Published: 2026-07-07

### [How OpenSuperWhisper Implements Auto-Paste into the Focused Application](/Starmel/OpenSuperWhisper/how-does-the-app-implement-auto-paste-into-the-focused-application)

Discover how OpenSuperWhisper seamlessly implements auto-paste into your focused application. Learn about its efficient system pasteboard and CGEvent API usage.

- Tags: how-to-guide
- Published: 2026-07-07

### [How Beam Search Decoding Improves Transcription Quality in OpenSuperWhisper](/Starmel/OpenSuperWhisper/how-does-beam-search-decoding-improve-transcription-quality)

Discover how beam search decoding enhances OpenSuperWhisper transcription quality by exploring parallel token sequences and selecting optimal hypotheses, minimizing errors.

- Tags: deep-dive
- Published: 2026-07-07

### [What Is the No-Speech Threshold in OpenSuperWhisper and How Is It Used?](/Starmel/OpenSuperWhisper/what-is-the-no-speech-threshold-and-how-is-it-used)

Learn about the no-speech threshold in OpenSuperWhisper. Discover how this setting prevents background noise from creating inaccurate transcriptions.

- Tags: deep-dive
- Published: 2026-07-07

### [How OpenSuperWhisper Handles Audio File Drag-and-Drop with Queue Processing](/Starmel/OpenSuperWhisper/how-does-the-app-handle-audio-file-drag-and-drop-with-queue-processing)

Discover how OpenSuperWhisper handles audio file drag and drop with queue processing. Learn how SwiftUI FileDropOverlay and TranscriptionQueue manage audio files effectively.

- Tags: how-to-guide
- Published: 2026-07-07

### [How Hold-to-Record Mode Works with Modifier Keys in OpenSuperWhisper](/Starmel/OpenSuperWhisper/how-does-the-hold-to-record-mode-work-with-modifier-keys)

Discover how OpenSuperWhisper uses modifier keys for push-to-talk recording. Learn about instant transcription startup and stop on key-up with a 0.3-second threshold.

- Tags: how-to-guide
- Published: 2026-07-07

### [How OpenSuperWhisper Dynamically Updates Available Microphones in the macOS Status Bar](/Starmel/OpenSuperWhisper/how-does-the-status-bar-menu-dynamically-update-available-microphones)

Discover how OpenSuperWhisper dynamically updates macOS status bar microphones. Learn about its Combine-based publisher-subscriber pattern for real-time audio device changes.

- Tags: internals
- Published: 2026-07-07

### [How OpenSuperWhisper Manages Microphone Permissions and Device Selection](/Starmel/OpenSuperWhisper/how-does-opensuperwhisper-manage-microphone-permissions-and-device-selection)

Discover how OpenSuperWhisper handles microphone permissions and device selection via two Swift services: PermissionsManager for system authorization and MicrophoneService for hardware management.

- Tags: how-to-guide
- Published: 2026-07-07

### [Understanding the TranscriptionEngine Protocol Architecture in OpenSuperWhisper](/Starmel/OpenSuperWhisper/what-is-the-architecture-of-the-transcriptionengine-protocol)

Uncover the TranscriptionEngine protocol architecture in OpenSuperWhisper. Learn how its 5 core Swift requirements decouple transcription workflows from implementations for efficient audio processing.

- Tags: architecture
- Published: 2026-07-07

### [How the OpenSuperWhisper Transcription Queue Handles Multiple Audio Files](/Starmel/OpenSuperWhisper/how-does-the-transcription-queue-handle-multiple-audio-files)

Discover how OpenSuperWhisper's async FIFO queue manages numerous audio files, ensuring efficient single-threaded transcription without compromising UI responsiveness.

- Tags: internals
- Published: 2026-07-07

### [How the Whisper Engine is Integrated in OpenSuperWhisper: Complete Technical Guide](/Starmel/OpenSuperWhisper/how-is-the-whisper-engine-integrated-in-opensuperwhisper)

Discover how the Whisper engine integrates into OpenSuperWhisper using a two-layer architecture. This technical guide details Swift class orchestration and C API interfacing.

- Tags: technical-guide
- Published: 2026-07-07

### [How OpenSuperWhisper Implements Global Keyboard Shortcuts Using Modifier-Only Keys](/Starmel/OpenSuperWhisper/how-does-opensuperwhisper-implement-global-keyboard-shortcuts-using-modifier-only-keys)

Discover how OpenSuperWhisper uses low-level event taps to enable global keyboard shortcuts with modifier-only keys like Left Command or Right Option. Trigger dictation effortlessly.

- Tags: how-to-guide
- Published: 2026-07-07

### [How to Contribute to the OpenSuperWhisper Project: A Comprehensive Developer Guide](/Starmel/OpenSuperWhisper/how-to-contribute-to-the-opensuperwhisper-project)

Contribute to the OpenSuperWhisper project by forking the repository, initializing submodules, installing dependencies, and building. Follow our guide to submit your pull request.

- Tags: how-to-guide
- Published: 2026-07-05

### [Managing Application Preferences in OpenSuperWhisper: A Swift Best Practices Guide](/Starmel/OpenSuperWhisper/what-are-the-best-practices-for-managing-application-preferences)

Master OpenSuperWhisper application preferences with this Swift guide. Discover type-safe `AppPreferences`, property wrappers, schema migration, and NotificationCenter for seamless UI updates.

- Tags: best-practices
- Published: 2026-07-05

### [How to Extend or Modify the Functionality of the Whisper Engine in OpenSuperWhisper](/Starmel/OpenSuperWhisper/how-to-extend-or-modify-the-functionality-of-the-whisper-engine)

Learn how to extend or modify the Whisper engine in OpenSuperWhisper by adjusting Swift wrappers, parameters, or implementing custom processing pipelines for enhanced functionality.

- Tags: how-to-guide
- Published: 2026-07-05

### [Whisper Engine Dependencies in OpenSuperWhisper: A Complete Technical Breakdown](/Starmel/OpenSuperWhisper/what-dependencies-does-the-whisper-engine-have)

Discover the Whisper engine dependencies in OpenSuperWhisper. Learn about its reliance on Apple frameworks, whisper.cpp, and internal Swift utilities, with no third-party packages.

- Tags: deep-dive
- Published: 2026-07-05

### [How to Handle Shortcut Conflicts in OpenSuperWhisper: Priority System and Resolution](/Starmel/OpenSuperWhisper/how-to-handle-shortcut-conflicts-in-the-application)

OpenSuperWhisper handles shortcut conflicts via a priority system. Learn how mouse hotkeys override modifier-only keys and regular shortcuts for seamless operation.

- Tags: how-to-guide
- Published: 2026-07-05

### [How to Define Global Keyboard Shortcuts in OpenSuperWhisper](/Starmel/OpenSuperWhisper/can-i-define-global-keyboard-shortcuts-for-opensuperwhisper)

Define global keyboard shortcuts for OpenSuperWhisper using the KeyboardShortcuts Swift package. Customize hotkeys for transcription, modifiers, or mouse buttons easily.

- Tags: how-to-guide
- Published: 2026-07-05

### [How to Debug Issues with ShortcutManager.swift in OpenSuperWhisper: A Complete Guide](/Starmel/OpenSuperWhisper/how-to-debug-issues-with-shortcutmanager-swift)

Debug ShortcutManager.swift issues in OpenSuperWhisper. Learn to verify trigger modes, add logging, and confirm shortcut registration for faster troubleshooting. Get the complete guide.

- Tags: how-to-guide
- Published: 2026-07-05

### [What Programming Language Is Used for the Whisper Engine in OpenSuperWhisper?](/Starmel/OpenSuperWhisper/what-programming-language-is-used-for-the-whisper-engine)

Discover the programming language behind the Whisper engine in OpenSuperWhisper. Learn how Swift provides a type-safe wrapper for model loading and transcription workflows.

- Tags: deep-dive
- Published: 2026-07-05

### [How to Use the Whisper Engine for Speech-to-Text on macOS with OpenSuperWhisper](/Starmel/OpenSuperWhisper/how-to-use-the-whisper-engine-for-speech-to-text-on-macos)

Learn to use the Whisper engine for speech to text on macOS with OpenSuperWhisper. Get high-quality offline transcription using this native Swift wrapper and its async transcribeAudio method.

- Tags: how-to-guide
- Published: 2026-07-05

### [What Are the Default Preferences Set in OpenSuperWhisper?](/Starmel/OpenSuperWhisper/what-are-the-default-preferences-set-in-opensuperwhisper)

Discover the default preferences in OpenSuperWhisper. Learn about transcription engines, model paths, and UI behavior stored in AppPreferences using @UserDefault wrappers.

- Tags: getting-started
- Published: 2026-07-05

### [How to Access or Modify Application Preferences Programmatically in OpenSuperWhisper](/Starmel/OpenSuperWhisper/how-to-access-or-modify-application-preferences-programmatically)

Learn to access and modify OpenSuperWhisper application preferences programmatically with AppPreferences.shared and read/write to UserDefaults instantly.

- Tags: how-to-guide
- Published: 2026-07-05

### [What Is the Role of AppPreferences.swift in Managing User Settings?](/Starmel/OpenSuperWhisper/what-is-the-role-of-apppreferences-swift-in-managing-user-settings)

Discover how AppPreferences.swift manages user settings for OpenSuperWhisper. This singleton provides type-safe access to UserDefaults for seamless setting persistence and retrieval.

- Tags: how-to-guide
- Published: 2026-07-05

### [How to Troubleshoot Whisper Engine Errors in OpenSuperWhisper: A Complete Diagnostic Guide](/Starmel/OpenSuperWhisper/how-to-troubleshoot-whisper-engine-errors-in-opensuperwhisper)

Troubleshoot OpenSuperWhisper Whisper engine errors: contextInitializationFailed, audioConversionFailed, and processingFailed. Fix common issues by checking model paths, audio formats, and parameters.

- Tags: how-to-guide
- Published: 2026-07-05

### [Performance Characteristics of the Whisper Engine in OpenSuperWhisper: 7 Real-Time Optimizations](/Starmel/OpenSuperWhisper/what-are-the-performance-characteristics-of-the-whisper-engine)

Discover the Whisper engine's impressive performance in OpenSuperWhisper. Learn how dynamic thread pools and parallel processing achieve sub-second transcription latency on macOS.

- Tags: performance
- Published: 2026-07-05

### [How to Integrate External Whisper Models with OpenSuperWhisper](/Starmel/OpenSuperWhisper/how-to-integrate-external-whisper-models-with-opensuperwhisper)

Integrate external Whisper models with OpenSuperWhisper. Download models, initialize MyWhisperContext, and pass to WhisperEngine for easy transcription.

- Tags: how-to-guide
- Published: 2026-07-05

### [How to Customize Whisper Engine Settings in OpenSuperWhisper: A Complete Configuration Guide](/Starmel/OpenSuperWhisper/can-i-customize-whisper-engine-settings-in-opensuperwhisper)

Customize Whisper engine settings in OpenSuperWhisper with this complete guide. Configure language detection, decoding, model parameters, and output easily via SwiftUI or code.

- Tags: how-to-guide
- Published: 2026-07-05

### [How to Implement Custom Keyboard Shortcuts in OpenSuperWhisper](/Starmel/OpenSuperWhisper/how-to-implement-custom-keyboard-shortcuts-in-opensuperwhisper)

Learn to implement custom keyboard shortcuts in OpenSuperWhisper using the Swift KeyboardShortcuts package. Customize global hotkeys and settings for a personalized workflow. Get started now!

- Tags: how-to-guide
- Published: 2026-07-05

### [Keyboard Shortcuts in ShortcutManager.swift: OpenSuperWhisper Recording Controls](/Starmel/OpenSuperWhisper/what-keyboard-shortcuts-are-available-in-shortcutmanager-swift)

Discover keyboard shortcuts in OpenSuperWhisper's ShortcutManager.swift. Learn to toggle recording with Option+backtick and cancel with Esc for efficient transcription control.

- Tags: how-to-guide
- Published: 2026-07-05

### [How Keyboard Shortcuts Are Managed in OpenSuperWhisper: Inside the ShortcutManager Singleton](/Starmel/OpenSuperWhisper/how-are-keyboard-shortcuts-managed-in-opensuperwhisper)

Discover how OpenSuperWhisper manages keyboard shortcuts with the ShortcutManager singleton, utilizing standard hotkeys, modifier keys, and mouse buttons for efficient control. Learn more about this macOS feature.

- Tags: internals
- Published: 2026-07-05

### [OpenSuperWhisper WhisperEngine.swift: Complete Guide to Speech-to-Text Implementation](/Starmel/OpenSuperWhisper/what-are-the-functionalities-of-whisperengine-swift)

Explore WhisperEngine.swift for seamless speech-to-text. Discover model loading, audio conversion, progress reporting, and thread-safe cancellation in this complete implementation guide for OpenSuperWhisper.

- Tags: deep-dive
- Published: 2026-07-05

### [How the Whisper Engine Works in OpenSuperWhisper: Complete Technical Implementation](/Starmel/OpenSuperWhisper/how-does-the-whisper-engine-work-in-opensuperwhisper)

Understand how the Whisper engine works in OpenSuperWhisper. Explore its Swift class, GGML model loading, audio conversion, and native C API integration for efficient transcription.

- Tags: internals
- Published: 2026-07-05

### [Where Is the Whisper Engine Implemented in OpenSuperWhisper?](/Starmel/OpenSuperWhisper/where-is-the-whisper-engine-implemented-in-opensuperwhisper)

Discover where the Whisper engine lives in OpenSuperWhisper. Find the core implementation in WhisperEngine.swift, handling model loading and inference via the native C library.

- Tags: internals
- Published: 2026-07-05

### [OpenSuperWhisper Configuration Options in AppPreferences.swift: Complete Reference Guide](/Starmel/OpenSuperWhisper/what-are-the-available-configuration-options-in-apppreferences-swift)

Explore all 21 configuration options in AppPreferences.swift for OpenSuperWhisper. Learn how to customize transcription language, hotkeys, and more with this complete reference guide.

- Tags: api-reference
- Published: 2026-07-05

### [How to Configure Application Preferences in OpenSuperWhisper: A Developer's Guide](/Starmel/OpenSuperWhisper/how-to-configure-application-preferences-in-opensuperwhisper)

Learn how to configure application preferences in OpenSuperWhisper. This guide details using AppPreferences, @UserDefault, and @OptionalUserDefault for seamless settings management.

- Tags: how-to-guide
- Published: 2026-07-05