Exportaste subtítulos para un video de producto y el archivo SRT parece correcto en un editor de texto. Al reproducirlo, dos frases aparecen a la vez y una tercera no se muestra. El problema puede estar en una marca de tiempo invertida, un número saltado o un bloque sin texto. Antes de subir el archivo, puedes pasar una revisión estructural en tu propio equipo y después mirar el video en los puntos señalados.
Según la descripción de SubRip de la Biblioteca del Congreso, cada bloque tiene un número, un tiempo de inicio y fin con la flecha -->, texto y una línea en blanco. El formato usa horas:minutos:segundos,milisegundos. YouTube admite archivos SRT básicos en texto UTF-8 y no reconoce sus marcas de estilo. Esas reglas permiten detectar errores mecánicos, pero no dicen si la transcripción es fiel, legible o sincronizada con la voz.
Qué revisa el script
El validador de abajo comprueba cinco cosas: que haya numeración consecutiva desde 1; que cada bloque tenga tiempo y texto; que el sello de tiempo tenga forma SRT y minutos y segundos válidos; que el final sea posterior al inicio; y que el inicio de un bloque no sea anterior al fin del anterior. Un solapamiento puede ser intencional en una edición especial, así que el mensaje significa revisar en video, no borrar automáticamente un subtítulo.

Guarda este código como validar_srt.py y ejecuta python3 validar_srt.py subtitulos.srt. Solo usa la biblioteca estándar de Python; no sube el archivo a ningún servicio.
import re
import sys
from pathlib import Path
STAMP = re.compile(r"^(\d{2}):(\d{2}):(\d{2}),(\d{3})$")
ARROW = re.compile(r"^(.+?)\s+-->\s+(.+?)$")
def ms(value):
match = STAMP.fullmatch(value)
if not match:
raise ValueError(f"marca inválida: {value}")
h, m, s, milli = map(int, match.groups())
if m > 59 or s > 59:
raise ValueError(f"minutos/segundos inválidos: {value}")
return ((h * 60 + m) * 60 + s) * 1000 + milli
def check(path):
blocks = re.split(r"\n\s*\n", path.read_text(encoding="utf-8-sig").strip())
issues = []
previous_end = None
for expected, block in enumerate(blocks, 1):
lines = block.splitlines()
if len(lines) < 3 or not lines[0].isdigit():
issues.append(f"bloque {expected}: faltan número, tiempo o texto")
continue
if int(lines[0]) != expected:
issues.append(f"bloque {expected}: número {lines[0]} fuera de secuencia")
match = ARROW.fullmatch(lines[1].strip())
if not match:
issues.append(f"bloque {expected}: línea de tiempo inválida")
continue
try:
start, end = map(ms, match.groups())
except ValueError as exc:
issues.append(f"bloque {expected}: {exc}")
continue
if end <= start:
issues.append(f"bloque {expected}: fin no posterior al inicio")
if previous_end is not None and start < previous_end:
issues.append(f"bloque {expected}: se solapa con el anterior")
if not "".join(lines[2:]).strip():
issues.append(f"bloque {expected}: texto vacío")
previous_end = end
return issues
if __name__ == "__main__":
if len(sys.argv) != 2:
sys.exit("Uso: python3 validar_srt.py subtitulos.srt")
issues = check(Path(sys.argv[1]))
print("\n".join(issues) if issues else "Estructura y tiempos básicos: OK")
sys.exit(bool(issues))
Si no encuentra problemas imprimirá Estructura y tiempos básicos: OK y devolverá código 0. Si encuentra alguno, mostrará el número de bloque y terminará con código 1: eso permite incorporarlo a un flujo local o a una acción de CI antes de publicar. Por ejemplo, un archivo con los bloques 1 y 3, donde el segundo empieza en 00:00:01,000 y termina en 00:00:00,900, informa el salto de numeración, el tiempo invertido y el solapamiento con el bloque previo.
Cómo usar el resultado sin perder tiempo
- Corrige primero el formato y los números. Si cambias un bloque, vuelve a ejecutar el validador: una corrección de tiempo puede crear un solapamiento nuevo.
- Abre el video en los segundos marcados y decide si dos frases deben coexistir o si una marca está equivocada. El script no puede oír la voz ni resolver eso por ti.
- Comprueba una muestra del inicio, medio y final, además de nombres propios y cifras. Reproduce en móvil: un archivo técnicamente válido aún puede tener líneas demasiado largas o desaparecer demasiado rápido.
- Si vas a subirlo a YouTube, conserva UTF-8 y usa el formato básico que documenta su ayuda. Si necesitas subtítulos con estilos o posicionamiento, consulta el formato aceptado por el destino antes de exportar.
Prueba propia: ejecutamos el script con un SRT de dos bloques correctos y devolvió cero problemas. Con un archivo de dos bloques que saltaba del 1 al 3 y tenía tiempo invertido, detectó los tres fallos descritos. No se ha probado con todas las variantes históricas de SubRip, codificaciones no UTF-8 ni un proyecto real de video. El código es un control previo, no un certificador universal.
La decisión práctica es sencilla: si produces subtítulos con frecuencia, incorpora esta verificación justo después de exportar y antes de subir. Te da una lista corta de lugares que mirar, sin afirmar que un archivo sin alertas es editorialmente perfecto.
Fuentes: Biblioteca del Congreso: estructura SubRip; YouTube: archivos de subtítulos compatibles.
