Minivoxhackable
Back to Vox

// minivox

The smallest possible dictation thing.

Open source and hackable. Press a shortcut, speak, and Minivox transcribes on your Mac and pastes the text. Use it as is, or tell your agents to embed it in your favorite project.

Right ⌘M to start · again to paste

// hand it to your agent

Tell your agents to embed it in your favorite project.

Minivox is nine Swift files on top of Vox, small enough for an agent to read in one pass. Paste the prompt into Claude Code, Codex, or whatever you build with.

apps/minivox/Sources9 files
  • MinivoxModel.swiftrecord, transcribe, paste
  • MinivoxNotch.swiftthe recording notch
  • MinivoxLivePreview.swiftwords as you speak
  • MinivoxPreferences.swiftshortcut and settings
  • ContentView.swiftmenu-bar popover
  • MinivoxMenuPages.swifthistory and settings pages
  • MinivoxCommandReceiver.swiftcommands from the CLI
  • MinivoxStyle.swiftcolors and type
  • MinivoxApp.swiftapp entry
Prompt for your agent

Embed Minivox-style dictation in this project. Read the Minivox source at https://github.com/hudsonkit/vox/tree/main/apps/minivox and https://voxd.cc/docs/start-swift. Add the Vox Swift package (VoxCore and VoxEngine) and use VoxDictation: warmUp() when the user shows intent, start() on one shortcut, stop() on the next, then paste result.text where the cursor is. Keep it as small as Minivox.

// one small job

From your voice to your cursor in three steps.

01

Press

Right ⌘M opens the notch and starts recording, from any app.

02

Speak

Your words stream into the notch as you talk, transcribed on your Mac.

03

Paste

Press again. Parakeet finishes the take and the text lands at your cursor.

// small on purpose

Nothing to take apart before you start.

Minivox embeds Vox directly: no daemon, browser bridge, reply engine, or speech-generation step. Fork it, change the shortcut or the notch, and it is still yours to read in an afternoon.

Pastes where you type

Stop recording and the text goes straight into the app you were in. It stays on the clipboard too, in case you want it twice.

Local Parakeet transcription

Audio never leaves the Mac. Minivox warms the model up ahead of time, so even a long first take comes back in a moment.

// run minivox

Install, then dictate.

One command installs the signed and notarized app and opens it; look for its waveform in the menu bar.

Installs the minivox command too. Add --quiet or --verbose to control setup output.

After installation

  1. 01Put the text cursor where you want your dictation.
  2. 02Press Right ⌘M to start, then allow microphone and Accessibility access.
  3. 03Press Right ⌘M again to stop. Minivox pastes the text at your cursor and leaves a copy on the clipboard.

The first dictation may download Parakeet. Open minivox settings to change the shortcut or microphone.