explaingit

jaswanth1524/vox-terminal

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 2/5Setup · moderate

TLDR

A local, offline dictation app for Apple Silicon Macs that pastes your speech as text into any focused app when you hold a hotkey.

Mindmap

mindmap
  root((Vox Terminal))
    What it does
      Local speech dictation
      Menu bar app
      Hotkey to paste text
    Tech stack
      Python
      MLX
      Parakeet
      Whisper
    Use cases
      Dictate into any app
      Offline transcription
      Custom vocabulary
    Audience
      Mac developers
      Terminal users
      Privacy conscious 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

Dictate text directly into a terminal, code editor, or browser without typing

USE CASE 2

Get fast, fully offline speech-to-text with no data sent to a remote service

USE CASE 3

Use custom vocabulary so technical terms like tool names transcribe correctly

What is it built with?

PythonMLXParakeetWhisper

How does it compare?

jaswanth1524/vox-terminal0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity2/52/54/5
Audiencedevelopergeneraldeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Apple Silicon and macOS 13+, about 3GB free disk space, and granting microphone, accessibility, and input monitoring permissions.

In plain English

Vox Terminal is a dictation app for Apple Silicon Macs that lets you speak instead of type into whatever text field you are currently focused on, whether that is a terminal, a code editor, a browser, or any other app. You hold the Right Option key, speak, release the key, and the words you said are pasted in as text within about four tenths of a second. All the speech recognition happens locally on your own machine using the MLX framework, with no audio ever sent to a remote transcription service. The app lives in your menu bar rather than as a normal window, and its icon changes to show whether it is ready, recording, or transcribing. From the menu you can also open settings, run diagnostics, view recent transcript history, and see performance reports, though history and audio are kept only in memory for the current session and cleared when the app quits. Getting it running requires macOS 13 or newer on an Apple Silicon Mac, with about 3 gigabytes of free space for the app and its chosen speech model. You can either download a signed release archive and verify its checksum before installing, or build it from source using Python, a tool called uv, and a small set of Homebrew packages. After installing, you approve a one time model download and grant the app three specific macOS permissions: microphone access to record audio, accessibility access to paste the finished text, and input monitoring so it can detect the global hotkey. By default it uses a fast English speech model called Parakeet, with an optional multilingual Whisper model for other languages or higher accuracy, and settings such as custom vocabulary words or whether to hold or toggle the recording key can be adjusted in a configuration file. Aside from the initial model download you approve, the app has no telemetry, analytics, or ongoing internet connection, and blocks outbound network activity by default during normal use.

Copy-paste prompts

Prompt 1
Show me how to install Vox Terminal on my Apple Silicon Mac from a release download
Prompt 2
Explain the macOS permissions Vox Terminal needs and why each one is required
Prompt 3
Help me build Vox Terminal from source using uv and the Makefile targets
Prompt 4
How do I switch Vox Terminal from the Parakeet model to Whisper for multilingual dictation

Frequently asked questions

What is vox-terminal?

A local, offline dictation app for Apple Silicon Macs that pastes your speech as text into any focused app when you hold a hotkey.

What language is vox-terminal written in?

Mainly Python. The stack also includes Python, MLX, Parakeet.

How hard is vox-terminal to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is vox-terminal for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.