Algunos dicen que ya hay suficientes herramientas de traducción automática con IA para subtítulos, entonces ¿cuál es el propósito de esta?
Es cierto que existen muchas herramientas para la traducción de videos en línea, y yo mismo he usado varias. Pero siempre sentí que no eran lo suficientemente precisas, o que la calidad dejaba mucho que desear, a veces incluso mostrando un montón de errores.
Además, comparto frecuentemente videos del extranjero en Twitter y WeChat Channels, así que decidí construir este conjunto de herramientas—en realidad puede ayudarte a migrar videos de plataformas extranjeras a las locales, jeje.
Usé este kit por medio año, lo ajusté muchas veces, y ahora está bastante maduro. Lo limpié y lo publiqué como código abierto para todos.
Una vez instalado, solo necesitas decir una frase: "Traduce este enlace a un video con subtítulos en español," y se encarga del resto automáticamente: descargar, transcribir, traducir, pulir, quemar subtítulos y generar una transcripción—un servicio completo de principio a fin.
La transcripción se ejecuta completamente en tu propia computadora, sin costos de API. La traducción usa la IA que ya tienes instalada. Y no es solo para inglés; videos en japonés, coreano, francés y otros idiomas extranjeros se pueden convertir a subtítulos en español.
En esencia, son solo unos pocos scripts más un manual. No está atado a Claude Code—OpenClaw, Gemini y Codex también pueden usarlo; la única diferencia es cómo cada herramienta instala las "habilidades".
A continuación, una guía paso a paso para instalarlo y procesar tu primer video.
¿Qué puede hacer exactamente esto?
Dale un enlace de video (YouTube, Bilibili, Douyin funcionan) o un archivo de video local, y completará estos cinco pasos de una sola vez:
Descargar → Transcribir → Traducir → Pulir → Quemar Subtítulos
...y finalmente, generar una transcripción.
Para desglosarlo:
- Descarga el video (o usa un archivo local directamente).
- Extrae el audio y usa Whisper para transcribirlo a subtítulos originales con marcas de tiempo precisas.
- Traduce el texto original al español y lo pule para crear subtítulos que se adapten a los hábitos de visualización en español.
- Quema los subtítulos en el video, generando un video con subtítulos en español.
- Simultáneamente, genera una transcripción en Markdown para facilitar el archivo o convertirlo en un artículo.
El idioma no importa. Inglés, japonés, coreano, francés, español—mientras Whisper pueda entenderlo, se puede convertir a subtítulos en español. Identifica automáticamente el idioma de origen y lo traduce. Para videos en español, solo transcribe y genera una transcripción sin el paso de traducción.
Hay dos opciones de subtítulos. Una es solo español para una pantalla limpia. La otra es bilingüe (español/inglés), con texto grande en español y texto pequeño en inglés, perfecto para quienes quieren practicar comprensión auditiva.
No necesitas recordar ningún comando. Solo usa lenguaje natural: "Quiero subtítulos bilingües," "Sin marca de agua," "Usa modo rápido"—lo entiende todo.
En pocas palabras, comprime un proceso que antes requería cuatro o cinco programas y una o dos horas de trabajo en una sola frase.
¿En qué se diferencia de las herramientas existentes?
Hay muchas herramientas de subtítulos en el mercado. A mí me importan tres cosas, y esta herramienta fue construida específicamente para ellas.
Primero: Local, gratuito y sin conexión. La transcripción usa el modelo Whisper de código abierto de OpenAI. En Macs con Apple Silicon, usa automáticamente aceleración por GPU. Todo el proceso de transcripción ocurre en tu computadora—sin cargas, sin costos. La traducción reutiliza la IA que ya tienes, sin necesidad de una API de traducción aparte.
Segundo: Marcas de tiempo precisas. Muchas herramientas tienen subtítulos que se adelantan al hablante o cortan las frases de manera extraña. Esta herramienta obtiene marcas de tiempo precisas hasta cuándo se dice cada palabra y corta basándose en "oración + pausa de respiración," así que los subtítulos cambian exactamente cuando el hablante termina una idea.
Tercero: Subtítulos para humanos, no solo traducción automática cruda. Corrige automáticamente nombres propios malinterpretados (Claude a menudo se escucha como "nube," MCP como "NCP"), divide oraciones por semántica, mantiene líneas de menos de doce caracteres y conserva el inglés para términos técnicos. En modo bilingüe, el español es grande y el inglés pequeño, claramente separados en lugar de solo dos líneas del mismo tamaño apiladas.
Estos son detalles que he refinado a lo largo de cientos de videos, todos integrados en las reglas.
Cómo se ven los resultados
Probemos una entrevista publicada recientemente por a16z con la ex CTO de OpenAI, Mira Murati. Le pedí a la herramienta que proporcionara subtítulos bilingües.
En sus palabras originales, había una metáfora:
Es más como una bicicleta tándem donde ambas personas pedalean.
La traducción automática podría darte una traducción literal torpe. Esta herramienta lo traduce como: "Es más como una bicicleta de dos personas, donde ambas pedalean juntas."
Es natural y fluido. Los nombres propios también se manejan bien; nombres de empresas como "Thinking Machines" se dejan en inglés en lugar de forzar una traducción.
Solo envías "Enlace + Traduce este video," y primero preguntará si quieres solo español o bilingüe—yo normalmente traduzco al español, así que dejé estas dos como opciones predeterminadas, pero en realidad puede traducir a cualquier idioma.
Además del video con subtítulos, también genera una transcripción con el texto original y el español lado a lado.
El párrafo completo se lee así:
Es más como construir un sistema que no solo se va por su cuenta y deja atrás a la civilización, sino que es más como una bicicleta tándem donde ambas personas pedalean. En la cuesta arriba, quizás la persona más fuerte pedalea con más fuerza, pero ambas personas tienen las manos en el manubrio.
La parte más práctica es que es independiente del idioma. La misma entrevista se puede traducir a subtítulos bilingües para español, japonés, coreano, árabe o francés—con la traducción arriba y el inglés abajo, claramente priorizados. Incluso el árabe de derecha a izquierda se alinea perfectamente:
Los videos de diez minutos no son problema, y los videos largos de más de una hora y media se manejan fácilmente.
En realidad son tres habilidades
Cuando abras el repositorio, verás tres carpetas, cada una gestiona una parte del trabajo. Se pueden usar individualmente o encadenadas:
- xiaohu-video-md: El comandante. Responsable de descargar, transcribir, llamar a la traducción, quemar subtítulos y generar la transcripción.
- xiaohu-subtitle-polish: Especializado en la traducción y pulido de subtítulos. Maneja corrección de errores, traducción, división de oraciones, alineación de tiempo y formato bilingüe.
- xiaohu-video-download: Una herramienta de descarga pura. Descarga videos, audio o listas de reproducción completas, y también puede quemar subtítulos en videos locales.
Al traducir un video, xiaohu-video-md es el orquestador, y llama a xiaohu-subtitle-polish para el paso de traducción. No necesitas preocuparte por esto; solo sabe que estas tres partes existen.
Instalación Paso a Paso
Esta herramienta está optimizada actualmente para Mac, funcionando más fluidamente en Apple Silicon. Hay dos formas de instalarla: si quieres algo fácil, solo pega el texto de abajo en tu IA; si quieres saber qué está pasando o te preocupan los errores, sigue los pasos manuales.
Versión Pérezosa: Dale esto a tu IA
Abre tu herramienta de codificación con IA (Claude Code, Codex, OpenClaw) y copia y pega lo siguiente exactamente. Determinará tu sistema, instalará dependencias, clonará el repositorio y ejecutará el script de instalación, haciéndote preguntas cuando sea necesario:
Ayúdame a instalar esta herramienta de traducción de videos: https://github.com/xiaohuailabs/xiaohu-video-translate Sigue este orden: 1. Revisa mi sistema: Mac o Windows; si es Mac, verifica si es Apple Silicon (serie M). 2. Instala dependencias: yt-dlp, ffmpeg, whisper-cpp (Usa brew install para Mac, WSL o winget para Windows). Motor de transcripción: Instala mlx-whisper para Apple Silicon, faster-whisper para otros. 3. git clone este repositorio, entra al directorio y ejecuta bash install.sh para instalar las tres habilidades en mi directorio de habilidades. 4. Una vez instalado, encuentra el config.json en la habilidad xiaohu-video-md (para Claude Code, está en ~/.claude/skills/). Pregúntame dónde quiero guardar los productos finales y ayúdame a cambiar output_dir a la ruta completa. 5. Finalmente, verifica si todas las dependencias están instaladas y dime si puedo empezar a usarlo.
Explica brevemente lo que hiciste en cada paso; si una dependencia falla, detente y pregúntame, no continúes sin más.
Básicamente ejecuta los tres pasos siguientes por ti. Si quieres hacerlo tú mismo o solucionar problemas, sigue la versión manual.
Paso 1: Instalar herramientas básicas
Primero, asegúrate de tener Homebrew instalado. Luego ejecuta este comando para instalar las tres herramientas:
brew install yt-dlp ffmpeg whisper-cpp
A continuación, instala un motor de transcripción. Para Macs con Apple Silicon, usa esto para aceleración por GPU (la bandera --break-system-packages es solo para evitar una restricción más reciente del sistema; no dañará tu sistema):
pip3 install --break-system-packages mlx-whisper
Si no es Apple Silicon, usa la versión general:
pip3 install --break-system-packages faster-whisper
Paso 2: Instalar habilidades en Claude
Clona el repositorio y ejecuta el script de instalación:
git clone https://github.com/xiaohuailabs/xiaohu-video-translate.git cd xiaohu-video-translate bash install.sh
Este script copia las tres habilidades al directorio de habilidades de Claude, genera archivos de configuración y verifica dependencias. Si todo muestra [OK], estás listo. Si algo muestra [Missing], sigue las indicaciones para solucionarlo. (Las rutas aquí usan Claude Code como ejemplo; para otras herramientas, solo cambia el directorio).
Paso 3: Indícale dónde guardar los resultados
Abre ~/.claude/skills/xiaohu-video-md/config.json y cambia output_dir a la ruta de la carpeta que desees (por ejemplo, /Users/tunombre/Documents/VideoTranslation).
Los archivos temporales van a tmp/, las transcripciones a data/, y los videos terminados van a tu carpeta de Descargas por defecto.
No necesitas descargar el modelo de transcripción manualmente. La primera vez que lo ejecutes,
mlx-whisperlo descargará (aproximadamente 1.5 GB) y lo reutilizará después.
Una vez hecho, reinicia tu herramienta de IA, y estás listo.
Usuarios de Windows, Miren Aquí
Lo anterior es para Mac. Windows también puede ejecutarlo, pero con algunas diferencias:
La forma más fácil es usando WSL (Subsistema de Windows para Linux). Una vez instalado, instala esto y el script funcionará tal cual:
sudo apt install ffmpeg pip3 install yt-dlp faster-whisper
Si no quieres usar WSL:
- Usa faster-whisper como motor.
- Ejecuta el script de instalación usando Git Bash, o copia las carpetas manualmente.
- Cambia la fuente de los subtítulos. La predeterminada es PingFang SC de Mac. Cámbiala a Microsoft YaHei en los comandos para evitar que el texto aparezca como cuadros.
Cómo usar
Una vez instalado, es solo una frase. Puedes decir cosas como:
- "Traduce este enlace a un video con subtítulos en español + [Enlace]"
- "Traduce este video, quiero subtítulos bilingües + [Enlace]"
- "Convierte este video a texto + [Enlace]" (Solo genera Markdown)
- "Agrega subtítulos en español a este video local + [Ruta]"
- "Descarga este video + [Enlace]"
- "Usa modo rápido para la transcripción"
- "Sin marca de agua al traducir"
Algunos problemas a tener en cuenta
YouTube a veces falla al descargar (error 403). El control de riesgos de YouTube se ha endurecido. El script intenta leer las cookies de tu navegador para reintentar. Si aún falla, usa un proxy.
Los subtítulos aparecen como cuadros. Esto es un problema de indexación de fuentes. Asegúrate de usar una fuente disponible en tu sistema (como PingFang SC en Mac).
Douyin requiere un inicio de sesión único. Ejecuta el script douyin_login.py y escanea el código QR. Esta información de inicio de sesión permanece solo en tu computadora.
Tómalo y úsalo
Dirección del repositorio:
github.com/xiaohuailabs/xiaohu-video-translate
El código tiene licencia MIT. Siéntete libre de cambiar marcas de agua, estilos o tamaños de fuente. Solo un recordatorio: no subas tus archivos de configuración o información de inicio de sesión de Douyin a repositorios públicos.
Esta es una herramienta que uso a diario, no un juguete. Si te resulta útil, dale una estrella. Si tienes problemas, abre un issue.
La próxima vez, publicaré como código abierto mi habilidad para ilustrar artículos—usando una imagen de IP personal para generar ilustraciones para artículos, como las de esta publicación.
