MTG-실시간 번역기

OpenAI Realtime Translation API を使った、데스크톱向けの실시간 번역앱(PySide6 製). マイクから入った音声をその場で翻訳し、テキストと音声で返します。 Silero VAD をローカルで走らせて、話し終わった瞬間にサーバへコミットさせるので、レイテンシは数百 ms 台。

リポジトリ:

デモ

こんな感じで動きます👇

위의 동영상이 재생されない場合は docs/videos/demo.mp4 から直接다운로드してください.

---

必要なもの

• macOS / Windows / Linux (동작확인은 macOS)
• 파이썬 3.10+
• OpenAI API キー(Realtime API が使えるもの)
• Zoom / Google Meet で使う場合は 가상 오디오장치(macOS は BlackHole を권장)

セットアップ

起動

ウィンドウが開いたら：

1. 출력 언어 — 번역先の言語を選ぶ
2. Input — 마이크(자신의 声をそのまま訳すならマイク、相手の声を訳すなら後述の仮想デバイス)
3. Output — 재생先のスピーカー
4. Start を押す → 話す → 번역텍스트가 流れてくる

'.env' 를 편집하는 대신 、셸에서 'OPENAI_API_KEY' をエクスポートしてもOK.

---

Zoom / Google Meet で使うとき

ここがこのアプリの本命の使い方です。 「相手が話している言語を、自分側でリアルタイムに翻訳して聞く／読む」 ためのセットアップ。

ポイントは 2 つ：

1. 会議アプリ側のスピーカー出力を、仮想オーディオデバイスに切り替える (Zoom / Meet の音声を、本アプリのマイク入力として横取りするため)
2. **本アプリの Input を그 가상 장치에 하는 ** （横取りした音声を翻訳エンジンに流し込むため）

なぜマイク／スピーカーを変える必要があるのか？ Zoom や Google Meet の音声は、普通は그 まま스피커から出るだけで、다른 アプリからは取れません. BlackHole のような 가상 오디오장치 を間에 挟むと、Zoom の出力 → BlackHole → 본アプリの입력, という配線ができ、相手の声を翻訳器に渡せるようになります。 같은 이유로 、本アプリ가 번역한 자신의 声 を회의의 상대에 届けたい場合は、Zoom / Meet 측の 마이크입력 を BlackHole에 切り替える必要があります.

절차(macOS / BlackHole の例)

1. BlackHole 2ch を설치('brew install blackhole-2ch' でも可)
2. 用途に合わせて配線する：

A. 相手の声を翻訳して聞く

• Zoom / Meet の 스피커 を 'BlackHole 2ch' に変更
• 本アプリの Input を 'BlackHole 2ch', Output 를 실스피커(MacBook のスピーカー等)에
• その

---

🌐 본 텍스트는 빠른 이해를 돕기 위한 요약 번역본입니다. 정확한 기술 정보 및 전체 코드는 GitHub 원문에서 확인하실 수 있습니다.