whatisgithub

What is livecaption?

six-ddc/livecaption — explained in plain English

Analysis updated 2026-05-18

20PythonAudience · generalComplexity · 3/5Setup · moderate

In one sentence

A Mac command-line tool that listens to audio in real time and produces live English-to-Chinese translated captions, entirely offline.

Mindmap

mindmap
  root((livecaption))
    What it does
      Live speech to text
      English to Chinese translation
    Tech stack
      Python
      Apple Silicon GPU
    Use cases
      Meeting captions
      Speaker-labeled transcripts
      Offline translation
    Audience
      Mac users needing captions

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

Get live translated captions for a Zoom or Teams call's system audio.

USE CASE 2

Transcribe and translate a microphone conversation with automatic speaker labeling.

USE CASE 3

Translate a pre-recorded English audio file into Chinese text.

USE CASE 4

Run speech translation fully offline with no cloud service needed.

What is it built with?

PythonuvHugging Face

How does it compare?

six-ddc/livecaptionalex72-py/aria-termuxanime0t4ku/gentleman
Stars202020
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity3/52/52/5
Audiencegeneraldevelopergeneral

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

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Downloads about 3.5GB of AI models on first run, capturing system audio needs a compiled helper and macOS permission.

So what is it?

livecaption is a command-line tool for Mac computers with Apple Silicon chips that listens to audio in real time, converts speech to text, and translates that text from English to Chinese. Everything runs locally on the device with no internet connection or cloud service required. The output goes to the terminal window or a text file. The tool can capture audio from a microphone, from system audio (such as the sound coming out of a Zoom or Teams call), or from both at the same time. It can also process a pre-recorded audio file. When listening to a conversation, it automatically identifies up to four different speakers and labels each line with a speaker tag like S1 or S2, so you can tell who said what. Under the hood, three separate AI models run in sequence. A speech recognition model converts spoken words into text. A speaker identification model figures out who is talking at each moment. A translation model then converts the transcribed text into Chinese. All three models run on the Mac's built-in graphics chip rather than the CPU, which keeps performance fast while the machine handles other tasks. The tool also uses a two-pass approach to accuracy: it shows a rough real-time transcript as you speak, then quietly re-processes each completed sentence to produce a cleaner final version. Setting up the tool requires a package manager called uv. On first run, it downloads the AI models automatically from Hugging Face, which totals roughly 3.5 gigabytes. Capturing system audio (meeting output rather than just the microphone) requires a small extra step: a helper program must be compiled from source, and macOS needs explicit permission granted in the Privacy settings under Screen and System Audio Recording. The README explains this permission step in detail because macOS sometimes grants it silently and incorrectly. The README is written primarily in Chinese. The description above is based on the available content.

Copy-paste prompts

Prompt 1
Help me install livecaption on my Apple Silicon Mac using uv.
Prompt 2
Set up livecaption to capture system audio from a meeting and grant the required macOS permissions.
Prompt 3
Explain how livecaption's two-pass transcription works to produce a cleaner final caption.

Frequently asked questions

What is livecaption?

A Mac command-line tool that listens to audio in real time and produces live English-to-Chinese translated captions, entirely offline.

What language is livecaption written in?

Mainly Python. The stack also includes Python, uv, Hugging Face.

How hard is livecaption to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is livecaption for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.