Repolode
Cerlancism

Cerlancism/chatgpt-subtitle-translator

Herramienta web y CLI para traducir archivos de subtítulos SRT línea por línea con ChatGPT o cualquier API compatible con OpenAI, incluidos modelos locales de Ollama.

Estrellas
391
Forks
43
Issues abiertos
4
Último commit
hace 6 días

¿Qué es?

Esta herramienta traduce archivos de subtítulos y texto sin formato con modelos de lenguaje grandes mediante la API de chat completions de OpenAI o cualquier proveedor compatible, como un servidor local de Ollama. Se basa en la traducción por líneas: elimina los índices y las marcas de tiempo de SRT antes de enviar el contenido y agrupa las líneas en lotes. Así reduce el uso de tokens y mantiene la cantidad de líneas de salida igual a la de entrada, para conservar la sincronización de los subtítulos.

Incluye una interfaz web y una interfaz de línea de comandos (CLI). La CLI permite reanudar tareas interrumpidas mediante un archivo de progreso, realizar una comprobación previa de moderación, limitar la frecuencia a solicitudes por minuto y elegir entre varios modos de salida estructurada (array, object, timestamp y none). El modo de agente opcional realiza varias pasadas de planificación sobre el archivo para crear un resumen contextual antes de traducir.

El proyecto está escrito en JavaScript y funciona con Node.js 20 o versiones posteriores.

Funciones clave

  • 01Interfaz web y de línea de comandos para traducir subtítulos SRT y texto sin formato
  • 02Agrupación por lotes basada en líneas que elimina elementos innecesarios de SRT para reducir el uso de tokens
  • 03Compatible con cualquier proveedor compatible con OpenAI, incluidos los modelos locales de Ollama
  • 04Modos de salida estructurada que mantienen las líneas traducidas alineadas con las de entrada
  • 05Reanudación del progreso y salida en streaming en la CLI
  • 06Modo de agente opcional que planifica el trabajo sobre todo el archivo antes de traducir

Casos de uso

  • Traducir archivos de subtítulos de películas o series a otro idioma
  • Localizar subtítulos SRT para contenido de video sin volver a sincronizarlos
  • Traducir subtítulos completamente sin conexión con un modelo local de Ollama
  • Traducir texto sin formato línea por línea y conservar el orden de las líneas

Inicio rápido

  1. 1

    Clona el repositorio

    git clone https://github.com/Cerlancism/chatgpt-subtitle-translator
  2. 2

    Accede al directorio

    cd chatgpt-subtitle-translator
  3. 3

    Instala los requisitos

    npm install
  4. 4

    Copia .env.example a .env y añade tu clave de API

    cp .env.example .env

Antes de usarlo

  • Como se indica en el README, se requiere Node.js 20 o posterior y un shell compatible con bash.
  • La calidad y el costo de la traducción dependen del modelo elegido; se necesitan claves de API de OpenAI, salvo que se use un proveedor local compatible como Ollama.

En colecciones

Temas

Preguntas frecuentes

¿Qué es chatgpt-subtitle-translator?
Herramienta web y CLI para traducir archivos de subtítulos SRT línea por línea con ChatGPT o cualquier API compatible con OpenAI, incluidos modelos locales de Ollama. Esta herramienta traduce archivos de subtítulos y texto sin formato con modelos de lenguaje grandes mediante la API de chat completions de OpenAI o cualquier proveedor compatible, como un servidor local de Ollama. Se basa en la traducción por líneas: elimina los índices y las marcas de tiempo de SRT antes de enviar el contenido y agrupa las líneas en lotes. Así reduce el uso de tokens y mantiene la cantidad de líneas de salida igual a la de entrada, para conservar la sincronización de los subtítulos.
¿chatgpt-subtitle-translator es gratuito? ¿Qué licencia tiene?
chatgpt-subtitle-translator es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿chatgpt-subtitle-translator sigue mantenido?
Mantenimiento activo. El último commit de chatgpt-subtitle-translator fue el 1 nov 2026.
¿Para qué puedo usar chatgpt-subtitle-translator?
Traducir archivos de subtítulos de películas o series a otro idioma Localizar subtítulos SRT para contenido de video sin volver a sincronizarlos Traducir subtítulos completamente sin conexión con un modelo local de Ollama Traducir texto sin formato línea por línea y conservar el orden de las líneas
¿Cómo se instala chatgpt-subtitle-translator?
Clona el repositorio: git clone https://github.com/Cerlancism/chatgpt-subtitle-translator Accede al directorio: cd chatgpt-subtitle-translator Instala los requisitos: npm install Copia .env.example a .env y añade tu clave de API: cp .env.example .env
¿Dónde consigo chatgpt-subtitle-translator?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Cerlancism/chatgpt-subtitle-translator

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados