whatisgithub

What is voco?

donald-ada/voco — explained in plain English

Analysis updated 2026-05-18

1SwiftAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

A native macOS menu bar app that turns your voice into text and types it into whatever app you are using.

Mindmap

mindmap
  root((Voco))
    What it does
      Voice to text via hotkey
      Live transcript HUD
      Inserts text into active app
    Tech stack
      Swift
      SwiftUI
      sherpa-onnx
    Use cases
      Hands free note taking
      Dictating messages and emails
      Bilingual Chinese English input
    Audience
      Mac users
      Vibe coders
      Writers

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 notes, messages, or emails hands free into any Mac app.

USE CASE 2

Use a fully local, offline speech to text model for privacy sensitive dictation.

USE CASE 3

Track dictation habits over time with the built in statistics page.

What is it built with?

SwiftSwiftUIsherpa-onnx

How does it compare?

donald-ada/vocoaltuzar/sonicflowcollinkite/steamcontrollerkit
Stars111
LanguageSwiftSwiftSwift
Setup difficultyeasyeasymoderate
Complexity2/52/53/5
Audiencegeneralgeneraldeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires granting microphone and accessibility permissions in macOS System Settings.

MIT license: use, modify, and distribute freely, including commercially, as long as the copyright notice is kept.

So what is it?

Voco is a native macOS voice input app built with SwiftUI that turns your speech into text inside whatever app you are already using. It lives quietly in the menu bar rather than as a full window, and the main settings window only opens when you need it. To use it, you press a hotkey and start speaking. A small heads up display at the top of the screen shows a live, partial transcript as you talk, so you can see the words appear in real time. Once the transcription is done, the finished text is inserted directly into whatever app currently has focus, whether that is a note, an email, or a chat window. Voco supports two ways of turning speech into text. One option is Volcengine, a cloud based transcription service, using either its newer API key system or an older app ID and access token method, with credentials stored securely in the macOS Keychain. The other option is a local model that runs entirely on your Mac using the sherpa onnx streaming runtime, so no audio needs to leave your device. The recommended local model handles both Chinese and English and downloads automatically the first time you use it. The app also includes a statistics page that tracks things like how much you have dictated, which apps you use it in most, and when you tend to use it, along with a basic skill for cleaning filler words like um out of transcripts. Voco needs microphone access to record audio and accessibility permissions to insert text and listen for the hotkey system wide. It requires macOS 14 or later on either Apple Silicon or Intel hardware, is written in Swift, and is released under the MIT license.

Copy-paste prompts

Prompt 1
Explain how Voco's press and hold versus toggle hotkey modes work.
Prompt 2
Walk me through setting up Voco's local sherpa-onnx model instead of the cloud based Volcengine option.
Prompt 3
What macOS permissions does Voco need and why does it need each one?
Prompt 4
Help me build the Voco.app DMG from source using the packaging scripts.

Frequently asked questions

What is voco?

A native macOS menu bar app that turns your voice into text and types it into whatever app you are using.

What language is voco written in?

Mainly Swift. The stack also includes Swift, SwiftUI, sherpa-onnx.

What license does voco use?

MIT license: use, modify, and distribute freely, including commercially, as long as the copyright notice is kept.

How hard is voco to set up?

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

Who is voco for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.