Video Tutorial

Documentación

Cómo Instalar el Traductor de Voz en Tiempo Real con Python (Windows, Mac y Linux)

Este script de Python traduce tu voz en tiempo real de español a inglés (y viceversa) y reproduce el audio traducido directamente en Zoom, Teams o Google Meet. Usa reconocimiento de voz, Google Translate y síntesis de voz, todo dentro de una interfaz gráfica moderna. No necesitas pagar ninguna API.

¿Cómo funciona?

El script captura el audio de tu micrófono, lo convierte en texto con SpeechRecognition, traduce el texto con deep-translator y genera el audio del idioma destino con gTTS. Ese audio se reproduce a través de un dispositivo virtual (VB-Cable) que Zoom o Teams detectan como micrófono.

Flujo del proceso

  • Captura tu voz desde el micrófono con sounddevice
  • Convierte la voz a texto con Google Speech Recognition
  • Traduce el texto (Español → Inglés o Inglés → Español) con deep-translator
  • Genera el audio traducido con gTTS y lo decodifica con miniaudio
  • Reproduce el audio traducido al dispositivo de salida seleccionado (VB-Cable o altavoz)
  • Muestra todo en una interfaz gráfica con CustomTkinter

Paso a paso: instalación completa

Paso 1 — Instalar Python

El script requiere Python 3.10 o superior. Si ya lo tienes instalado, salta al Paso 2.

Windows

  • Descarga el instalador desde https://www.python.org/downloads/
  • Ejecuta el .exe y marca la casilla "Add Python to PATH" antes de hacer clic en Install Now
  • Verifica la instalación abriendo el CMD (Win + R → cmd):
py --version

macOS

  • Descarga el instalador .pkg desde https://www.python.org/downloads/
  • Ejecuta el instalador y sigue los pasos del asistente
  • Abre la Terminal y verifica:
python3 --version

Linux (Ubuntu / Debian)

  • Verifica si ya está instalado:
python3 --version
  • Si necesitas instalarlo:
sudo apt update
sudo apt install python3 python3-pip

Paso 2 — Descargar el proyecto

Descarga el archivo traductor.zip desde el enlace del video, extráelo en una carpeta de tu elección. La estructura debe verse así:

traductor/
├── main.py
├── requirements.txt
├── instalar.bat        ← solo Windows
└── app/
    ├── gui.py
    ├── speech.py
    ├── translator.py
    └── audio_manager.py

Paso 3 — Instalar las dependencias

Todas las librerías necesarias están listadas en el archivo requirements.txt. Elige la opción según tu sistema:

Windows — Instalador automático (recomendado)

Haz doble clic en instalar.bat. Si hay errores de permisos, clic derecho → Ejecutar como administrador. El instalador verifica Python, instala todos los paquetes y muestra un resumen al terminar.

-Tambien puedes instalar con requerimets.txt como se ve en el video con el siguiente comando:

py -m install -r requirements.txt

macOS y Linux — Con requirements.txt

pip3 install -r requirements.txt

Paso 4 — Instalar VB-Cable

VB-Cable es un driver de audio virtual gratuito que crea un micrófono virtual en tu sistema, permitiendo que Zoom, Teams o Meet reciban el audio ya traducido.

Windows

  • Descarga desde https://vb-audio.com/Cable/
  • Extrae el ZIP y ejecuta VBCABLE_Setup_x64.exe como Administrador
  • Reinicia el equipo cuando el instalador lo pida
  • Tras el reinicio verás el dispositivo CABLE Input (VB-Audio Virtual Cable) en tu configuración de audio

macOS

  • Descarga VB-Cable para Mac desde https://vb-audio.com/Cable/
  • Abre el paquete .pkg y sigue el asistente
  • Ve a Preferencias del Sistema → Seguridad y privacidad y permite la extensión del sistema si macOS lo solicita
  • Reinicia el equipo

Linux — Con PulseAudio (alternativa gratuita)

pactl load-module module-null-sink sink_name=VirtualMic sink_properties=device.description=VirtualMicrophone
pactl load-module module-virtual-source source_name=VirtualMicSource master=VirtualMic.monitor

Selecciona VirtualMicSource como micrófono en Zoom o Teams.

Paso 5 — Configurar VB-Cable en Zoom, Teams o Meet

Zoom

  • Configuración → Audio → Micrófono: selecciona CABLE Output (VB-Audio Virtual Cable)

Microsoft Teams

  • Configuración → Dispositivos → Micrófono: selecciona CABLE Output (VB-Audio Virtual Cable)

Google Meet

  • Tres puntos → Configuración → Audio → Micrófono: selecciona CABLE Output (VB-Audio Virtual Cable)

Paso 6 — Ejecutar el traductor

Abre una terminal en la carpeta del proyecto y ejecuta:

Windows

py main.py

macOS y Linux

python3 main.py

Se abrirá la interfaz gráfica. Desde ahí:

  • Selecciona tu micrófono real como entrada
  • Selecciona CABLE Input (VB-Audio Virtual Cable) como salida
  • Elige el idioma de origen y destino
  • Haz clic en Iniciar y comienza a hablar

Solución de problemas comunes

  • Error: py no reconocido — Reinstala Python y asegúrate de marcar "Add Python to PATH". Reinicia la terminal después.
  • Los paquetes no se instalan — Ejecuta instalar.bat como Administrador.
  • No detecta el micrófono — Verifica los permisos de micrófono en la configuración de privacidad del sistema operativo.
  • Zoom no escucha el audio traducido — Confirma que seleccionaste CABLE Output como micrófono en Zoom, no CABLE Input.
  • La traducción no funciona — El script requiere conexión a internet para Google Translate y gTTS.

Librerías Necesarias

py -m customtkinter
py -m deep-translator
py -m SpeechRecognition
py -m sounddevice
py -m soundfile
py -m numpy
py -m gTTS
py -m miniaudio
py -m cffi
py -m requests
py -m pyttsx3
py -m Pillow

Código Fuente Principal

"""
Traductor en Tiempo Real — Español ↔ Inglés
Punto de entrada principal de la aplicación
"""
import sys
import os

# Asegurar que el directorio del proyecto esté en el path
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))

from app.gui import TranslatorApp

if __name__ == "__main__":
    app = TranslatorApp()
    app.run()
/////////////////////////////////////////////////////////////////////////////////
ESTE CODIGO ES SOLO DEL MAIN AL SER MUCHOS ARCHIVOS DEBES OBTENER EL CODIGO DIRECTAMENTE DE LOS SCRIPTS DESCARGADOS.