Tutorial: Traductor de Archivos SRT

📋 Tabla de Contenidos

🔧 Requisitos Previos
⚙️ Instalación y Configuración
📁 Estructura del Proyecto
▶️ Cómo Ejecutar el Script
📝 Ejemplos de Uso
🔧 Personalización
🚨 Solución de Problemas

🔧 Requisitos Previos

1. Python 3.7+

# Verificar versión de Python

python --version

# o

python3 --version

2. Ollama Instalado

⚠️ Importante: Ollama debe estar ejecutándose localmente para que el script funcione.

1 Descarga Ollama desde ollama.ai

2 Instala y ejecuta Ollama

3 Descarga un modelo de lenguaje (recomendado: llama3.2:latest)

# En terminal, después de instalar Ollama:

ollama pull llama3.2:latest

# o cualquier otro modelo que prefieras:

# ollama pull llama2

# ollama pull gemma

# ollama pull mixtral

3. Dependencias de Python

# Instalar requests

pip install requests

# o para pip3

pip3 install requests

⚙️ Instalación y Configuración

1. Descargar el Script

Copia el archivo traducir_srt.py a tu directorio de trabajo.

📥 Descarga directa: 💾 Descargar traducir_srt.py

2. Configurar Carpetas

📁 TuProyecto/
├── 📄 traducir_srt.py
├── 📁 entrada/ # Aquí van los archivos SRT a traducir
└── 📁 salida/ # Aquí se guardarán las traducciones

💡 Tip: Las carpetas entrada y salida se crean automáticamente si no existen.

📁 Estructura del Proyecto

📁 MiProyectoTraducciones/
├── 📄 traducir_srt.py # Script principal
├── 📁 entrada/
│ ├── 📄 video1_en.srt # Archivo SRT original
│ ├── 📄 video2_en.srt # Otro archivo SRT
│ └── 📄 ... # Más archivos SRT
├── 📁 salida/
│ ├── 📄 video1_en.srt # Traducción completada
│ ├── 📄 video2_en.srt # Traducción completada
│ └── 📄 ... # Más traducciones
└── 📄 tutorial_traducir_srt.html # Este tutorial

Archivos SRT de Ejemplo

1
00:00:01,234 --> 00:00:04,567

Hello, welcome to this video about artificial intelligence.

2

00:00:04,568 --> 00:00:07,890

Today we will explore the fundamentals of AI.

▶️ Cómo Ejecutar el Script

Método 1: Ejecución Directa

# Navega al directorio del proyecto

cd /ruta/a/tu/proyecto

# Ejecuta el script

python traducir_srt.py

# o

python3 traducir_srt.py

Método 2: Ejecución con Python

# Si tienes múltiples versiones de Python

python3 traducir_srt.py

✅ Progreso: El script procesará automáticamente todos los archivos .srt en la carpeta entrada

📝 Ejemplos de Uso

Ejemplo 1: Traducción Básica

🔍 Encontrados 3 archivos SRT para traducir

🌐 Traduciendo 'video1_en.srt' con mistral en Ollama...

✅ Traducción completada: salida/video1_en.srt

🌐 Traduciendo 'video2_en.srt' con mistral en Ollama...

✅ Traducción completada: salida/video2_en.srt

🌐 Traduciendo 'video3_en.srt' con mistral en Ollama...

✅ Traducción completada: salida/video3_en.srt

Ejemplo 2: Sin Archivos SRT

⚠️ No se encontraron archivos .srt en la carpeta de entrada

Ejemplo 3: Error de Conexión

⚠️ Error de conexión con Ollama: HTTPConnectionPool...

🔧 Personalización

Cambiar el Modelo de Lenguaje

# En traducir_srt.py, línea 7:

modelo = "mistral"   # Cambia por otro modelo

# Opciones: llama2, gemma, mixtral, codellama, etc.

Cambiar Carpetas

# En traducir_srt.py, líneas 5-6:

carpeta_entrada = "entrada"

carpeta_salida = "salida"

Personalizar el Prompt

# En traducir_srt.py, línea 13:

prompt = f"Traduce al castellano de forma natural y concisa. Mantén el sentido original y usa un lenguaje natural:\n\n{texto}"

🚨 Solución de Problemas

Error: "No se pudo decodificar"

Solución: El archivo SRT tiene una codificación no soportada. El script intenta automáticamente UTF-8, UTF-16, Latin1 y CP1252.

Error: "Error de conexión con Ollama"

1 Verifica que Ollama esté ejecutándose: ollama list

2 Si no está ejecutándose, inicia Ollama

3 Verifica que el modelo esté descargado: ollama pull mistral

Error: "Model not found"

# Descarga el modelo especificado

ollama pull mistral

# o cambia el modelo en el script

Traducción no funciona correctamente

Posibles causas:

El modelo no está optimizado para traducción
El prompt puede necesitar ajustes
Prueba con un modelo diferente

Script no encuentra archivos

Verifica:

Que los archivos tengan extensión .srt
Que estén en la carpeta entrada
Que no haya espacios extra en los nombres

🎯 Consejos y Mejores Prácticas

💡 Optimización: Para mejores resultados de traducción, considera usar modelos más grandes como "mixtral" o "llama2:13b".

💡 Backup: Siempre mantén copias de seguridad de tus archivos SRT originales.

💡 Batch Processing: El script procesa todos los archivos .srt automáticamente, ideal para traducir múltiples videos.

💡 Monitoreo: Revisa la consola para ver el progreso y posibles errores durante la traducción.

🚀 Tutorial: Traductor de Archivos SRT