Ir al contenido
yt-dlp

Descargar subtítulos de YouTube — Generador de comandos yt-dlp

Crea un comando de yt-dlp que guarde los subtítulos como .srt sin descargar el vídeo.

Opcional. Si lo dejas vacío, el comando termina en URL para que la rellenes tú.

Tu comando

yt-dlp --write-subs --convert-subs srt --sub-langs en --write-auto-subs --no-playlist -s 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'
Básico

Solo audio extrae la pista sonora y descarta el vídeo.

Vídeo y calidad

Limita la altura. yt-dlp sigue eligiendo la mejor pista igual o por debajo.

El tipo de archivo en el que se fusionan las pistas de vídeo y audio separadas.

Opciones avanzadas (3)

Sustituye a la lista de calidad. Para quien ya conoce la sintaxis de formatos.

Reempaqueta las pistas sin recodificar. Rápido y sin pérdida.

Recodifica el vídeo. Lento y con pérdida: solo cuando remux no sirva.

Audio

El archivo al que se convierte el audio.

VBR da la mejor relación tamaño-calidad; los bitrates fijos son más previsibles.

Subtítulos

Incrustar los mete dentro del vídeo; guardar escribe un .srt aparte junto a él.

Separados por comas. Usa all para todos los idiomas disponibles.

Listas y canales

Qué hacer cuando la URL pertenece a la vez a un vídeo y a una lista.

Funcionan rangos y listas, por ejemplo 1-10,15 o -5::2 para uno de cada dos desde el final.

Opciones avanzadas (1)

Anota lo ya descargado para que una nueva ejecución lo omita. Es la forma de mantener un canal sincronizado.

Fragmentos y capítulos
Opciones avanzadas (2)

Un rango como *00:01:30-00:03:00, o el nombre de un capítulo. El asterisco inicial indica que es una marca de tiempo.

Metadatos y portada
Opciones avanzadas (3)
SponsorBlock

Corta del archivo los fragmentos marcados por la comunidad, según los datos de SponsorBlock.

Opciones avanzadas (1)

Conserva los fragmentos pero los marca, para que los saltes tú.

Archivos y carpetas

Los campos van en %(...)s. Las barras crean carpetas.

Opciones avanzadas (4)

Dónde se escriben los archivos. Combínalo con la plantilla de arriba para crear subcarpetas.

Longitud máxima del nombre de archivo, en caracteres.

Filtros
Opciones avanzadas (5)

AAAAMMDD, o una fecha relativa como now-1month.

AAAAMMDD, o una fecha relativa.

Omite lo más pequeño. Acepta 5M, 500K y similares.

Omite lo más grande.

Número de archivos a descargar antes de detenerse.

Red

Por ejemplo 2M o 500K. Útil cuando necesitas el resto del ancho de banda.

Opciones avanzadas (5)

Acelera las pistas fragmentadas. Cuatro es un punto de partida razonable.

Cuántas veces reintentar una parte fallida. Se admite infinite.

URL de proxy HTTP, HTTPS o SOCKS.

Hace que las peticiones parezcan de un navegador real. Es la solución habitual a un 403 repentino.

Sesión y cookies

Lee directamente tu sesión. Necesario para contenido privado, con restricción de edad o solo para miembros.

Opciones avanzadas (1)

Un cookies.txt en formato Netscape exportado desde tu navegador.

Directos
Opciones avanzadas (2)

Consulta hasta que empiece un directo programado. MIN-MAX segundos entre comprobaciones.

Soluciones alternativas
Opciones avanzadas (3)

Obsoleto en favor de --add-headers. Se mantiene porque muchas guías antiguas siguen usándolo.

Obsoleto en favor de --add-headers.

Opciones específicas de cada sitio, por ejemplo youtube:player_client=web.

Salida y depuración
Opciones avanzadas (2)
Restablecer

Subtítulos sin el vídeo

El modo simulación hace todo excepto escribir el archivo de vídeo, así que te quedas con los subtítulos y te ahorras la descarga. Convertirlos a SRT necesita ffmpeg.

Si no aparece nada, lo más probable es que el vídeo no tenga subtítulos escritos por personas: los automáticos son una opción aparte y, sin activarla, yt-dlp no encuentra nada y tampoco lo dice.

El modo simulación es el interruptor que sostiene esta página: sin él, yt-dlp descarga el vídeo entero y además guarda los subtítulos, lo que en un archivo de duración de película es mucha transferencia para una pista de texto. Con él, la tanda trae los metadatos, escribe los archivos de subtítulos y no toca nunca el vídeo. El precio es que el modo simulación también se salta la escritura de la miniatura y la descripción a la que quizá estabas acostumbrado — esos son artefactos de una pasada de vídeo, no de subtítulos.

La selección de idioma es donde las descargas de subtítulos se vuelven delicadas. --sub-langs en toma exactamente la pista etiquetada "en"; en-orig es el nombre de YouTube para la generada automáticamente, y en.* como patrón atrapa ambas más las variantes regionales. Varios idiomas admiten una lista separada por comas. Si un vídeo tiene pista humana y automática para el mismo idioma, son dos entradas separadas, y descargar ambas es un resultado legítimo, no un bug.

Los formatos importan cuando el archivo de subtítulos va a un editor: SRT es el intercambio seguro, VTT lleva el estilo que muestra el reproductor web, y los formatos JSON3/_SRV propios de YouTube están pensados para máquinas. El interruptor de conversión a SRT resuelve el caso común, necesita ffmpeg y pierde el estilo a propósito — los editores quieren texto, no marcado. Si la salida se ve vacía, comprueba que el archivo exista antes de suponer que falló la conversión: un SRT de cero bytes significa que la pista misma estaba vacía.

Los subtítulos automáticos merecen una advertencia: son transcripción de máquina, con todo lo que eso implica — homófonos equivocados, sin puntuación, nombres destrozados. Para un vídeo en un idioma que lees son un índice de búsqueda; para cualquier cosa que vayas a citar, la pista humana (cuando existe) es la que merece conservarse. Los directos reciben sus subtítulos automáticos en directo, guardados solo cuando la emisión termina — las opciones de grabación en directo de este sitio son para la imagen, y las leyendas de una emisión terminada se descargan con las opciones normales de subtítulos.

Preguntas frecuentes

¿Cómo descargo subtítulos sin el vídeo?
Elige la opción .srt y activa simular, que omite escribir el archivo de vídeo pero guarda los subtítulos.
¿Por qué no apareció ningún archivo de subtítulos?
Probablemente el vídeo no tenga subtítulos humanos. Activa los automáticos para obtener los generados por máquina.
¿Cómo elijo los idiomas de los subtítulos?
Sepáralos por comas, por ejemplo en,es. Usa all para todos los disponibles, o un patrón como en.* para todas las variantes de inglés.
¿Puedo obtener SRT en lugar de VTT?
Sí, la opción .srt los convierte, y eso necesita ffmpeg.