Convierte subtítulos JSON3 de YouTube a SRT, VTT o LRC

Cuando descargas subtítulos de YouTube, el formato más cercano al dato original es JSON3: el formato timedtext estructurado que YouTube usa internamente. Guarda cada detalle del subtítulo, incluidos los tiempos en milisegundos, los desfases por palabra y los segmentos de texto. El problema es que casi nada fuera de YouTube lee JSON3. Esta guía explica cómo extraer los subtítulos y convertirlos en segundos a SRT, VTT o LRC.

Qué es el formato JSON3

JSON3 es el formato timedtext basado en JSON que YouTube usa para almacenar y entregar subtítulos. Cada subtítulo es un objeto de evento con una hora de inicio en milisegundos (tStartMs), una duración (dDurationMs) y uno o más segmentos de texto (segs). Los segmentos pueden incluir un desfase por palabra (tOffsetMs) para una sincronización estilo karaoke.

Al ser JSON estructurado, conserva más información de tiempo que cualquier formato habitual de reproductor. Eso lo convierte en el mejor formato intermedio si buscas fidelidad, y en el peor si pretendes entregarlo directamente a un reproductor. La solución es sencilla: descarga JSON3 y conviértelo después.

Cómo descargar subtítulos de YouTube en JSON3

Opción 1: yt-dlp (recomendado)

La forma más fiable es yt-dlp, el sucesor mantenido de youtube-dl. Para descargar solo los subtítulos automáticos en inglés, sin el vídeo:

yt-dlp --write-auto-subs --sub-lang en --sub-format json3 --skip-download "https://www.youtube.com/watch?v=VIDEO_ID"

Se creará un archivo .json3 en la carpeta actual. Si existe una pista editada por personas, usa --write-subs, porque suele ser más precisa.

Opción 2: API timedtext de YouTube

El endpoint timedtext puede devolver JSON3 directamente. Sustituye el identificador del vídeo y el código de idioma en esta URL:

https://www.youtube.com/api/timedtext?v=VIDEO_ID&lang=es&fmt=json3

El navegador mostrará el contenido JSON3. Los subtítulos automáticos pueden requerir parámetros adicionales y YouTube a veces restringe este endpoint.

Opción 3: extensión de navegador

Varias extensiones añaden un botón de descarga en YouTube y exportan JSON3 o VTT. Son cómodas para casos puntuales, pero ofrecen menos control que yt-dlp sobre idiomas y formato de salida.

Por qué convertir JSON3

Ningún reproductor estándar, editor de vídeo ni aplicación de letras lee JSON3. Cada destino tiene su motivo:

• SRT para compatibilidad universal: reproductores de escritorio, televisores, móviles y editores.
• VTT para vídeo web: WebVTT es el estándar W3C de subtítulos para HTML5.
• LRC para letras sincronizadas en reproductores de música.

Flujo de conversión

1. Descarga el archivo JSON3. Usa yt-dlp o la API timedtext.
2. Elige el conversor. Según el destino, usa JSON to SRT, JSON to VTT o JSON to LRC.
3. Sube y convierte. El proceso se ejecuta en tu navegador y el archivo no sale de tu equipo.
4. Descarga y verifica. Abre el resultado en un editor de texto o reprodúcelo con el vídeo para comprobar la sincronización.

Qué ocurre con los tiempos

JSON3 contiene la información temporal más rica, por lo que parte de ella se simplifica al convertir:

• Los desfases por palabra se agrupan en las horas de inicio y fin de cada subtítulo.
• La precisión de milisegundos se mantiene en SRT y VTT; LRC redondea a centésimas.
• Las horas de fin se conservan en SRT y VTT, pero LRC solo registra inicios.

En la práctica, estas pérdidas no afectan a la legibilidad y las horas de inicio y fin siguen siendo precisas.

Problemas comunes y soluciones

• El JSON3 está vacío o es minúsculo. Puede que no exista pista en ese idioma. Prueba otro valor de --sub-lang o revisa el botón CC.
• Los subtítulos automáticos se desfasan. Son aproximados, sobre todo en vídeos largos. Si hay una pista editada, será mejor.
• Los caracteres especiales se ven mal. JSON3 es UTF-8; comprueba que la herramienta de destino también lo use.
• Se descargan varios idiomas. Limita la pista con --sub-lang.

Privacidad y seguridad del archivo

Los subtítulos pueden contener material sensible. Si descargas con una herramienta local y conviertes en el navegador, todo el flujo permanece en tu equipo: sin subidas, sin servidores externos y sin archivos que limpiar después.

Listo para convertir

JSON3 captura los subtítulos de YouTube con la mayor fidelidad posible. Convertirlo a SRT, VTT o LRC lo vuelve útil en el mundo real y solo toma unos segundos.