whatisgithub

What is dji-mic-wispr-flow?

caezium/dji-mic-wispr-flow — explained in plain English

Analysis updated 2026-05-18

9ShellAudience · generalComplexity · 2/5Setup · easy

In one sentence

A macOS tool that turns your DJI Mic Mini 2's linking button into a hands-free remote for starting and stopping Wispr Flow dictation.

Mindmap

mindmap
  root((dji-mic-wispr-flow))
    What it does
      Maps mic button to dictation
      Starts stops Wispr Flow
      Works wirelessly across room
    Tech stack
      Shell
      Karabiner-Elements
      macOS
    Use cases
      Hands free dictation
      Custom hotkey remap
      Safe config merge
    Audience
      Mac users
      Wispr Flow users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Start and stop hands-free dictation in Wispr Flow by pressing your DJI Mic Mini 2 button

USE CASE 2

Remap a DJI microphone's remote-shutter button to any custom keyboard shortcut

USE CASE 3

Merge a new Karabiner-Elements rule into an existing config without losing your other rules

What is it built with?

ShellKarabiner-ElementsmacOS

How does it compare?

caezium/dji-mic-wispr-flowdiogox451/principal-software-architecthwdsl2/docker-litellm
Stars999
LanguageShellShellShell
Last pushed2026-07-09
MaintenanceActive
Setup difficultyeasyeasymoderate
Complexity2/53/53/5
Audiencegeneraldeveloperpm founder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires a DJI Mic Mini 2 receiver plugged in via USB-C and Karabiner-Elements permissions granted.

No license information was found in the README.

So what is it?

Dji mic wispr flow is a small macOS tool that turns the linking button on a DJI Mic Mini 2 wireless microphone transmitter into a remote control for a dictation app called Wispr Flow. If you clip the microphone to your collar, pressing its button starts hands free dictation, and pressing it again stops the recording and inserts the transcribed text wherever your cursor is. Because the signal travels over DJI's own wireless link rather than Bluetooth, it works from across a room. Installation is a single command that downloads and runs a script. That script installs a tool called Karabiner Elements if it is not already present, and it merges its own rule into your existing Karabiner setup so nothing you already have configured is lost, backing up your old settings first. After installing, you need to approve a driver extension and turn on Input Monitoring permission for Karabiner in your Mac's privacy settings. Once the DJI receiver is plugged in over USB-C and Wispr Flow is set to use it as the microphone, pressing the transmitter's button triggers Flow's hands free shortcut, which defaults to Fn plus Space but can be changed to a different key combination when running the installer. Under the hood, the DJI microphone's receiver has a feature meant for taking photos remotely: pressing the transmitter's button makes the receiver send a volume key press over USB. Karabiner Elements watches for that specific key press, but only from the DJI device, and remaps it to Wispr Flow's dictation shortcut instead of letting it change the Mac's system volume. This only works when the receiver is connected by USB-C, since Bluetooth only mode does not expose these button presses. The repository is mostly a shell script for installing and merging the Karabiner configuration, along with a reference copy of a fully working setup file. It is a small project with 9 stars, written primarily in Shell script, and credits a similar project that captures the same button press for macOS's built in dictation feature instead of Wispr Flow.

Copy-paste prompts

Prompt 1
Walk me through installing dji-mic-wispr-flow on my Mac
Prompt 2
Help me change the Wispr Flow hotkey this script triggers to Ctrl+Option
Prompt 3
Explain how Karabiner-Elements remaps the DJI Mic's volume keypress

Frequently asked questions

What is dji-mic-wispr-flow?

A macOS tool that turns your DJI Mic Mini 2's linking button into a hands-free remote for starting and stopping Wispr Flow dictation.

What language is dji-mic-wispr-flow written in?

Mainly Shell. The stack also includes Shell, Karabiner-Elements, macOS.

What license does dji-mic-wispr-flow use?

No license information was found in the README.

How hard is dji-mic-wispr-flow to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is dji-mic-wispr-flow for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.