ASR-app is a lightweight, blazing-fast, and aesthetically stunning native macOS menu bar application designed for instant speech-to-text input across any application. Press a global hotkey, dictate your thoughts, and the transcribed text will be automatically typed directly into your active text field.

Designed with modern macOS LiquidGlass principles, combining deep translucency, vibrant neon gradients, and organic micro-animations.

• 🎙️ Blazing-Fast Transcription (Whisper Turbo): Audio is sent directly to the Groq Whisper Large V3 Turbo API, ensuring near-instant transcription (under one second) and maximum accuracy.

• 📋 Smart Auto-Paste: Once transcription is complete, the text is copied to your clipboard and immediately pasted into your active application (web browser, IDE, chat app) using an simulated Cmd+V keystroke.

• 🎨 Premium LiquidGlass UI:

  • A beautiful, adaptive translucent Menu Bar Popover.
  • An interactive animated real-time volume indicator (Neon Wave) with glowing reflections.
  • A gorgeous borderless «About» (About ASR-app) window featuring dynamic animated liquid glass gradient blobs.

• 🌐 Complete Multilingual Support (En, Ru, Ua):

  • Matches your macOS system language by default.
  • Dynamic on-the-fly UI language switching (English, Russian, Ukrainian) without app restarts.
  • Choice of dictation language (Auto-detect or specific languages, including complete support for Ukrainian uk).

• 🌗 Adaptive Themes:

  • Integration with System (inherits macOS settings), Dark, and Light themes.
  • Adapts translucency, materials, and glows instantly.

• ⌨️ Global Hotkeys: Dictate from anywhere in macOS without opening the popover. Pick your preferred global shortcut (e.g., ⌥ + Space) in settings to start and stop recording seamlessly.

• Language: Swift 5.10+
• Frameworks: SwiftUI & AppKit
• System Integration:
  • AVFoundation — high-fidelity audio capture and real-time decibel level monitoring.
  • Carbon API — low-level global shortcut tracking from anywhere.
  • CoreGraphics (CGEvent) — secure keyboard emulation for Smart Auto-Paste.
• Build System: XcodeGen (dynamic .xcodeproj generation from project.yml for a clean Git repository).

• macOS 14.0 or newer.
• XcodeGen installed on your system.

1. Install XcodeGen using Homebrew:

   brew install xcodegen

2. Clone the repository and navigate to its folder:

   git clone https://github.com/YOUR_USERNAME/ASR-app.git
   cd ASR-app

3. Generate the Xcode project from project.yml:

   xcodegen generate

4. Open the newly generated project file:

   open ASRApp.xcodeproj

5. Press Cmd + R in Xcode to compile and run!

To enable speech-to-text recognition, you need a free API key from Groq:

1. Log in or sign up at console.groq.com.
2. Generate a new API key in the API Keys section.
3. Click the waveform icon in the macOS status bar ➔ Open Settings (gear icon ⚙️) ➔ Paste your API key into the field.

This project features a fully configured DevOps pipeline:

• When you push a Git version tag starting with v (e.g., v1.1.0), the GitHub Actions release workflow is triggered.
• On a high-performance cloud runner (macos-14 Apple Silicon), the pipeline installs XcodeGen, compiles the release build, and packages the binary into an ad-hoc .app folder.
• The application folder is compressed into a ASRApp.zip archive.
• Detailed release notes (Release Notes / Changelog) are auto-generated based on commit logs.
• A GitHub Release is created, and the ASRApp.zip is automatically uploaded as a release asset.

• Alex — Product visionary, co-creator, and lead QA engineer.
• Eva — Your AI pair-programmer, developer, and visual designer 🫂🍵✨.

Created with love, hot tea, and deep care for every pixel! 🍵✨