Skip to content

franklioxygen/v2v

Repository files navigation

v2v

v2v app icon

Real-time voice translation for macOS.

v2v is a macOS menu-bar app for meetings, calls, livestreams, and videos. It can capture microphone audio or the audio from a running app, send it to Google Gemini Live Translate, show bilingual subtitles, and play translated speech out loud.

Website · 中文文档

What It Does

v2v helps you follow live speech in a way that is easier to read and easier to hear:

  • Shows a floating bilingual subtitle overlay while people are talking.
  • Captures audio from the microphone or from a single running macOS app.
  • Plays translated speech out loud so you can listen instead of only reading.
  • Stores your Google API key in the macOS Keychain.

Features

  • Menu-bar workflow with quick access to controls.
  • Floating bilingual subtitles for source text and translated text.
  • Microphone capture and per-app audio capture.
  • Gemini Live Translate streaming for source transcription, target translation, and translated audio.
  • Output device selection, echo safety controls, and multi-source cloud usage warnings.

Language Support

v2v supports the BCP-47 language codes supported by Gemini Live Translate. You can let the app detect the source language, provide a language hint, and choose the target language in Settings.

Quick Start

  1. Download the latest .app.zip from Releases.
  2. Unzip it and move v2v.app to your Applications folder.
  3. Launch v2v. It appears in the macOS menu bar.
  4. Choose an input source: microphone or a running app.
  5. Save your Google API key and select the source-language hint and target language.
  6. Click Start.

The first time you use v2v, macOS may ask for these permissions:

  • Microphone: needed when the input source is the microphone.
  • Audio Capture: needed when the input source is another app.

Requirements

  • macOS 26 or later
  • A working Google Gemini API key

Build

swift test
xcodebuild -project v2v.xcodeproj -scheme v2v -configuration Debug build

License

MIT

About

v2v is a macOS menu-bar app for Translate, show bilingual subtitles, and play translated speech out loud.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors