Ir al contenido
yt-dlp

Generador de comandos yt-dlp para X (Twitter)

Crea un comando de yt-dlp para un vídeo de X, con nombres de archivo previsibles y las opciones que exige el contenido sensible.

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

Tu comando

yt-dlp --merge-output-format mp4 --no-playlist -o '%(uploader_id)s - %(id)s.%(ext)s' https://x.com/user/status/1234567890
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

Notas sobre X

Funcionan las URL de x.com y de twitter.com. Lo que en X se llama GIF son en realidad vídeos MP4 cortos, así que se descargan como cualquier otro; convierte después si necesitas un GIF de verdad.

Las publicaciones con contenido sensible requieren una sesión con ese ajuste activado. La plantilla por defecto nombra los archivos por autor e id de la publicación, lo que mantiene navegable una carpeta llena de ellos.

X ha cambiado su superficie de API varias veces, y la consecuencia práctica es que los arreglos del extractor llegan en las actualizaciones de yt-dlp a los pocos días — una instalación de más de unas semanas es donde viven de verdad la mayoría de los informes de "X está roto". Actualiza antes de depurar: yt-dlp -U. El acceso de invitado va y viene; cuando lo retiran, una sesión identificada con cookies es la vía que funciona, y también es la única vía al contenido sensible.

Los hilos y los posts-cita son donde las URL se lían. Un tuit con vídeo lo incrusta; el mismo vídeo en la pestaña de medios del perfil es una entrada aparte. Para una cuenta entera, la URL de la pestaña de medios trae todo lo publicado con medios, paginado, y el archivo de registro más continuar tras los errores se encarga de los posts borrados que una cuenta activa acumula inevitablemente. Las descargas por URL de búsqueda se excluyen a propósito aquí: los resultados derivan entre peticiones, y un registro sobre una búsqueda en movimiento no significa nada.

X sirve el vídeo como fragmentos HLS con una alternativa MP4 en la mayoría de los casos, así que las fusiones son habituales y ffmpeg es la dependencia que conviene comprobar primero. Los posts "GIF" son la excepción que conviene conocer: llegan como MP4 como todo lo demás, y convertirlos después en un GIF de verdad es trabajo de ffmpeg, no de yt-dlp — un WebM en bucle suele acercarse más a lo que la persona que lo envió quería decir.

Los posts con restricción de edad y el contenido sensible son el muro duro: el ajuste vive en la cuenta, no en el comando. Inicia sesión una vez desde el navegador, activa el ajuste de medios sensibles, entrega las cookies, y funciona — no existe atajo sin cookies, porque X comprueba la sesión en el servidor. Los posts borrados se comportan como en cualquier otro sitio: borrado es borrado, y los espejos que antes guardaban copias cerraron hace años.

Preguntas frecuentes

¿Por qué falla una publicación con restricción de edad en X?
El contenido sensible requiere una sesión identificada. Usa --cookies-from-browser con una cuenta que tenga ese ajuste activado.
¿Cómo descargo un GIF de X?
Son vídeos MP4, no GIF, y se descargan como cualquier otro vídeo. Convierte después si necesitas un GIF real.
¿Puedo elegir la calidad del vídeo en X?
Sí. X publica varias versiones: limita la altura con la lista de calidad o enuméralas primero con -F.