Cómo usar gallery-dl con Twitter / X

gallery-dl reconoce distintos tipos de URL de Twitter / X: una publicación concreta, la pestaña /media de un usuario, cronologías, Me gusta, marcadores, listas, búsquedas y otras páginas que admite el extractor. Para el primer trabajo conviene usar una publicación pública o la pestaña de medios de una cuenta. Copia la URL canónica de x.com, escríbela entre comillas y simula la extracción antes de crear archivos.

La simulación confirma si la versión instalada es suficientemente reciente, si la URL activa el extractor correcto, si hace falta iniciar sesión y qué elementos serían seleccionados. Una cronología puede mezclar republicaciones, respuestas, citas, vídeos y medios repetidos. Por eso, reconocer la URL no significa todavía que el alcance predeterminado coincida con lo que necesitas.

gallery-dl --simulate "https://x.com/USUARIO/status/ID_PUBLICACION"

gallery-dl --simulate "https://x.com/USUARIO/media"

gallery-dl -K "https://x.com/USUARIO/status/ID_PUBLICACION"

Twitter restringe cada vez más el acceso anónimo a las cronologías. Si gallery-dl indica que necesita cookies autenticadas, inicia sesión de forma normal en un perfil de navegador que controles, comprueba que allí se abre la página objetivo y señala ese perfil local en el comando. No hace falta pegar valores de cookies en esta web ni compartirlos con terceros.

Cierra por completo el navegador si su base de datos de cookies está bloqueada y verifica que has elegido el mismo perfil donde permanece activa la sesión de X. Una sesión caducada, una comprobación adicional de la cuenta, contenido privado, restricciones de edad o permisos específicos pueden seguir impidiendo la extracción. Las cookies solo reproducen el acceso que ya tiene tu cuenta.

gallery-dl --cookies-from-browser firefox --simulate "https://x.com/USUARIO/media"

gallery-dl --cookies-from-browser chrome --simulate "https://x.com/USUARIO/media"

gallery-dl --cookies-from-browser edge --simulate "https://x.com/USUARIO/media"

Cuando la simulación funcione, elige una carpeta predecible y añade un archivo de descargas. Ese archivo registra los identificadores extraídos con éxito y los omite en futuras ejecuciones, incluso si cambian los nombres de salida. Haz la primera descarga real con un rango pequeño, revisa rutas y tipos de medios y aumenta el alcance solo después de confirmar el resultado.

El extractor puede incluir o excluir respuestas, republicaciones, publicaciones citadas, tarjetas, artículos, vistas previas, mensajes solo de texto y vídeos. Los valores predeterminados pueden cambiar entre versiones. Examina los metadatos con -K antes de crear formatos de nombre o filtros y no publiques rutas de perfiles, datos de sesión ni ubicaciones privadas en scripts compartidos.

gallery-dl --cookies-from-browser firefox --range "1-25" --download-archive "twitter.sqlite3" "https://x.com/USUARIO/media"

gallery-dl --destination "D:/Media/X" --download-archive "twitter.sqlite3" "https://x.com/USUARIO/media"

gallery-dl --write-metadata --download-archive "twitter.sqlite3" "https://x.com/USUARIO/media"

Pasa las opciones al archivo de configuración solo cuando el comando ya funcione. La configuración oficial expone ajustes de Twitter como include, replies, retweets, quoted, videos, tamaño preferido, reintentos de API y tratamiento del límite de solicitudes. Un bloque pequeño y revisado es más fácil de mantener que copiar todas las opciones sin saber cuáles cambian el resultado.

El ejemplo mantiene los vídeos, excluye respuestas, republicaciones y citas, espera ante un límite y usa un archivo estable. Puedes dejar la selección de cookies en la línea de comandos si distintas máquinas emplean perfiles diferentes. Valida el JSON: los comentarios, las comas finales y las barras invertidas de Windows sin escapar invalidan el archivo.

{
  "extractor": {
    "twitter": {
      "replies": false,
      "retweets": false,
      "quoted": false,
      "videos": true,
      "ratelimit": "wait",
      "archive": "D:/gallery-dl/twitter.sqlite3"
    }
  }
}

gallery-dl --config-ignore --simulate "https://x.com/USUARIO/media"

gallery-dl --config-status

No mezcles autenticación, límites, resultados vacíos y duplicados. AuthRequired suele indicar cookies ausentes o caducadas. HTTP 429 o un aviso de límite significa que debes esperar en lugar de reintentar de forma agresiva. Un resultado vacío puede deberse a una URL inadecuada, contenido inaccesible, una configuración restrictiva o un archivo que ya contiene esos identificadores.

Compara una simulación limpia con --config-ignore y la misma URL con tus ajustes habituales. Añade después cookies, rango, archivo y filtros uno por uno. Actualiza gallery-dl mediante el mismo canal de instalación, confirma la versión y consulta las incidencias del proyecto antes de asumir que repetir solicitudes resolverá un cambio de X.

gallery-dl es un descargador local, no un sistema de permisos. Descarga solo contenido al que tengas acceso y derecho de uso, respeta la privacidad, los derechos de autor, las condiciones aplicables y la ley. No compartas cookies, tokens, archivos privados ni datos personales descargados. Que una URL sea técnicamente accesible no concede una licencia para republicarla.

El 30 de julio de 2026 este sitio verificó gallery-dl 1.32.8 en los metadatos oficiales de PyPI y confirmó que los archivos oficiales de Codeberg para Windows y Linux responden con HTTP 200, nombres correctos y tamaños esperados. El comportamiento de X puede cambiar; vuelve a revisar la versión y la documentación oficial si un comando deja de funcionar.