OpenSuperMLX is a macOS application that provides real-time audio transcription powered by MLX on Apple Silicon. It offers a seamless way to record and transcribe audio with customizable settings and keyboard shortcuts.
- 🎙️ Real-time audio recording and transcription
- 🔴 Streaming transcription — see results as you speak
- 🧠 MLX-based transcription engine — download models directly from the app
- ⌨️ Global keyboard shortcuts — tap to toggle or hold to record, fully customizable
- 📁 Drag & drop audio files for transcription with queue processing
- 🎤 Microphone selection — switch between built-in, external, Bluetooth and iPhone (Apple Continuity) mics from the menu bar
- 🌍 Support for multiple languages with auto-detection
- 🇯🇵🇨🇳🇰🇷 Asian language autocorrect (autocorrect)
- 🤖 AWS Bedrock LLM post-transcription correction (optional)
- 👋 First-launch onboarding flow
brew tap axot/tap
brew install --cask opensupermlxDownload from GitHub releases page.
Since OpenSuperMLX is not signed with an Apple Developer ID, macOS will block the app on first launch. You need to manually approve it:
- Open the app — macOS will show a warning that it cannot be opened
- Go to System Settings → Privacy & Security
- Scroll down to the Security section — you'll see a message about OpenSuperMLX being blocked
- Click Open Anyway
- Confirm in the dialog that appears
You only need to do this once. After approval, the app will launch normally.
OpenSuperMLX supports two recording modes via a global keyboard shortcut — it works from any app:
| Shortcut | Action |
|---|---|
⌥`` (Option + Backtick) |
Start/stop recording |
⌥⇧`` (Option + Shift + Backtick) |
Start/stop recording with LLM correction |
Escape |
Cancel active recording |
The shortcut automatically switches between two modes based on how you press it:
- Tap (quick press & release) — Toggles recording on and off. Press once to start recording, press again to stop. The transcribed text is automatically pasted into the frontmost app.
- Hold (press and hold) — Records while the key is held down. Release to stop and the transcribed text is automatically pasted into the frontmost app.
Tip: Shortcuts are fully customizable in Settings → Shortcuts.
- macOS 15.1+ (Apple Silicon/ARM64)
If you encounter any issues or have questions, please:
- Check the existing issues in the repository
- Create a new issue with detailed information about your problem
- Include system information and logs when reporting bugs
To build locally, you'll need:
git clone git@github.com:axot/OpenSuperMLX.git
cd OpenSuperMLX
git submodule update --init --recursive
brew install cmake libomp rust ruby
gem install xcpretty
./run.sh build
In case of problems, consult .github/workflows/build.yml which is our CI workflow
where the app gets built automatically on GitHub's CI.
OpenSuperMLX is licensed under the MIT License. See the LICENSE file for details.
OpenSuperMLX is forked from OpenSuperWhisper by @Starmel. Thanks to the original project for providing the foundation for this work.
MLX models are downloaded automatically from Hugging Face when selected in the app. Built-in models:
- Qwen3-ASR-0.6B-4bit — Smallest model, fastest inference
- Qwen3-ASR-1.7B-8bit — Recommended balance of accuracy and speed
- Qwen3-ASR-1.7B-bf16 — Highest quality, best accuracy
Custom models can be added via HuggingFace repository ID.
![@dependabot[bot]](https://avatars.githubusercontent.com/in/29110?s=64&v=4){kind=small}