whatisgithub

What is gemini-live-translate-macos?

kkdai/gemini-live-translate-macos — explained in plain English

Analysis updated 2026-05-18

13SwiftAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A macOS app that listens to audio from another app, like Chrome or Zoom, and shows a live translated subtitle overlay using Google's Gemini Live Translate API.

Mindmap

mindmap
  root((MeetingTranslator))
    What it does
      Live audio translation
      Floating subtitles
      Optional voice playback
    Tech stack
      Swift
      SwiftUI
      ScreenCaptureKit
      Gemini Live API
    Use cases
      Translate video audio
      Follow Zoom meetings
      Study API integration
    Audience
      macOS developers
      Multilingual meeting users
    Requirements
      macOS 13 or later
      Gemini API key
      Screen recording permission

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 subtitles for a YouTube video or streaming audio playing in another app.

USE CASE 2

Follow along with a Zoom or Google Meet call in a different language with real-time subtitles.

USE CASE 3

Hear translated audio played back aloud alongside the original speaker's pace and tone.

USE CASE 4

Study a working example of ScreenCaptureKit audio capture combined with a Gemini Live WebSocket connection.

What is it built with?

SwiftSwiftUIScreenCaptureKitGemini Live API

How does it compare?

kkdai/gemini-live-translate-macosa9eelsh/heliocoreappdev/clipdock
Stars131313
LanguageSwiftSwiftSwift
Setup difficultymoderatehardmoderate
Complexity3/53/52/5
Audiencedeveloperdevelopergeneral

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires macOS 13+, Xcode or Swift, a Gemini API key with Live Translate preview access, and granting screen recording permission for audio capture.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

This is a macOS desktop app called MeetingTranslator. It listens to audio playing inside another app on your Mac, translates that audio in real time using Google's Gemini 3.5 Live Translate service, and shows the translation as floating subtitles on screen. You can also turn on a setting to hear the translated speech played back aloud. The README is written in Traditional Chinese, and the project was built shortly after Google officially released this translation API in June 2026. The key technical choice is that the app captures audio from other apps using a built-in macOS framework called ScreenCaptureKit. This means you do not need to install extra virtual audio software that many similar tools require. You pick which running app to listen to from a dropdown list, such as Chrome playing a YouTube video or a Zoom meeting window, and the app grabs only that audio. The captured audio is sent over a WebSocket connection to Google's Gemini Live API, which returns both a text transcript of what was said and a translated audio stream. The subtitles scroll in a floating window, and the translated voice plays back with minimal delay. The README notes that the translation preserves the original speaker's pace and tone. To use it you need a Mac running macOS 13 or later, Xcode or the Swift compiler to build the app, and a Gemini API key from Google AI Studio. The README includes both a one-command build script and manual Xcode setup steps. On first run, macOS will ask for screen recording permission because ScreenCaptureKit requires it even when capturing only audio. The README also documents several technical problems the author encountered while building this, including which exact model name to use in the API call and how to safely copy multi-channel audio buffers to avoid silent output.

Copy-paste prompts

Prompt 1
Walk me through building MeetingTranslator with the included build_app.sh script and getting a Gemini API key.
Prompt 2
Explain how ScreenCaptureKit lets this app capture audio from just one other app without virtual audio drivers.
Prompt 3
Help me set up macOS screen recording permission so MeetingTranslator can capture app audio.
Prompt 4
Show me how the WebSocket connection to Gemini Live handles multi-channel audio buffer copying safely.

Frequently asked questions

What is gemini-live-translate-macos?

A macOS app that listens to audio from another app, like Chrome or Zoom, and shows a live translated subtitle overlay using Google's Gemini Live Translate API.

What language is gemini-live-translate-macos written in?

Mainly Swift. The stack also includes Swift, SwiftUI, ScreenCaptureKit.

What license does gemini-live-translate-macos use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is gemini-live-translate-macos to set up?

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

Who is gemini-live-translate-macos for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.