A Karabiner-Elements configuration for controlling Mac applications (Warp terminal, SuperWhisper, and more) using an 8BitDo Micro Bluetooth controller.
This project allows you to control your Mac from a distance using an 8BitDo Micro Bluetooth controller paired with a wireless microphone setup (such as DJI Mic). This setup is ideal for:
- Controlling your terminal (Warp) from anywhere in your home
- Managing voice transcription with SuperWhisper
- Navigating between applications and windows
- Controlling audio volume
- Executing common keyboard shortcuts wirelessly
- 8BitDo Micro Bluetooth controller
- Wireless microphone system (e.g., DJI Mic)
- Mac computer
- Karabiner-Elements - A powerful keyboard customizer for macOS
- SuperWhisper (optional) - For voice transcription
- Warp Terminal (optional) - For terminal control
- Install Karabiner-Elements from https://karabiner-elements.pqrs.org/
- Connect your 8BitDo Micro controller to your Mac via Bluetooth
- Copy the
8bit vibe.jsonfile to your Karabiner configuration folder:cp "8bit vibe.json" ~/.config/karabiner/assets/complex_modifications/ - Open Karabiner-Elements, go to "Complex Modifications" tab, click "Add rule", and enable the "8BitDo Micro - Finalized Warp and Dev Controls with L/R buttons" rule
| 8BitDo Button | Mac Action | Description |
|---|---|---|
| G | Option + Space | Likely activates SuperWhisper |
| H | Escape | Exit/Cancel |
| N | Control + C | Terminal interrupt |
| J | Enter | Confirm/Execute |
| K | Command + K, Z | Clear terminal/Zoom |
| I | Command + D | Duplicate line/Split terminal |
| M | Volume Up | Increase volume |
| R | Volume Down | Decrease volume |
| E | Option + Command + Down | Terminal navigation |
| F | Option + Command + Up | Terminal navigation |
| C | Option + Command + Left | Terminal navigation |
| D | Option + Command + Right | Terminal navigation |
| Y | Command + W | Close window/tab |
| Q | Command + S | Save |
| W | Command + Tab | Switch application |
| O | Command + A | Select all |
| P | Command + Z | Undo |
- Add support for 'Apply All' in Windsurf IDE
- Additional application-specific shortcuts
- Custom profiles for different workflows
Contributions are welcome! Feel free to fork this repository and submit pull requests with your own key mappings and improvements.
MIT License
- Karabiner-Elements for the incredible keyboard customization tool
- 8BitDo for the compact and versatile controller
- SuperWhisper for the voice transcription capabilities