gallery dl
1.27.7
gallery-dl es un programa de línea de comandos para descargar galerías y colecciones de imágenes de varios sitios de alojamiento de imágenes (consulte Sitios compatibles). Es una herramienta multiplataforma con muchas opciones de configuración y potentes capacidades de denominación de archivos.
Contenido
Dependencias
Opcional
Instalación
Pepita
Ejecutable independiente
Construcciones nocturnas
Quebrar
chocolateado
Cuchara
cerveza casera
Puertos Mac
Estibador
Uso
Ejemplos
Configuración
Documentación
Ubicaciones
Autenticación
Nombre de usuario y contraseña
Galletas
OAuth
Pitón 3.4+
Solicitudes
yt-dlp o youtube-dl: descargas de vídeos HLS/DASH, integración con ytdl
FFmpeg: conversión de Pixiv Ugoira
mkvmerge: códigos de tiempo de fotogramas Ugoira precisos
PySocks: soporte de proxy SOCKS
brotli o brotlicffi: soporte de compresión Brotli
zstandard: soporte de compresión Zstandard
PyYAML: compatibilidad con archivos de configuración YAML
toml: Compatibilidad con archivos de configuración TOML para Python <3.11
SecretStorage: Contraseñas del conjunto de claves de GNOME para --cookies-from-browser
Las versiones estables de gallery-dl se distribuyen en PyPI y se pueden instalar o actualizar fácilmente usando pip:
python3 -m pip instalar -U galería-dl
También se puede instalar la última versión de desarrollo directamente desde GitHub con pip:
python3 -m pip install -U -I --no-deps --no-cache-dir https://github.com/mikf/gallery-dl/archive/master.tar.gz
Nota: los usuarios de Windows deben usar py -3 en lugar de python3 .
Se recomienda utilizar la última versión de pip, incluidos los paquetes esenciales setuptools y wheel . Para asegurarse de que estos paquetes estén actualizados, ejecute
python3 -m pip install --actualizar rueda de herramientas de configuración de pip
Los archivos ejecutables prediseñados con un intérprete de Python y los paquetes de Python necesarios incluidos están disponibles para
Windows (requiere el paquete redistribuible de Microsoft Visual C++ (x86))
linux
Los ejecutables compilados a partir de la última confirmación se pueden encontrar en
https://github.com/gdl-org/builds/releases
Los usuarios de Linux que utilizan una distribución compatible con Snapd pueden instalar gallery-dl desde Snap Store:
instalación instantánea de galería-dl
Los usuarios de Windows que tengan instalado Chocolatey pueden instalar gallery-dl desde el repositorio de paquetes de la comunidad Chocolatey:
choco instalar galería-dl
gallery-dl también está disponible en el depósito "principal" de Scoop para usuarios de Windows:
primicia instalar galería-dl
Para usuarios de macOS o Linux que utilizan Homebrew:
cerveza instalar galería-dl
Para usuarios de macOS con MacPorts:
puerto sudo instalar galería-dl
Usando el Dockerfile en el repositorio:
clon de git https://github.com/mikf/gallery-dl.gitcd gallery-dl/ docker build -t galería-dl:latest .
Extrayendo imagen de Docker Hub:
extracción de ventana acoplable mikf123/gallery-dl etiqueta acoplable mikf123/gallery-dl gallery-dl
Extrayendo imagen de GitHub Container Registry:
extracción de la ventana acoplable ghcr.io/mikf/gallery-dl etiqueta acoplable ghcr.io/mikf/gallery-dl gallery-dl
Para ejecutar el contenedor, probablemente desee adjuntar algunos directorios en el host para que el archivo de configuración y las descargas puedan persistir en las ejecuciones.
Asegúrese de descargar la referencia del archivo de configuración de ejemplo en el repositorio y colocarla en la ubicación del volumen montado o tocar un archivo vacío allí.
Si le dio al contenedor una etiqueta diferente o está usando podman, asegúrese de ajustarlo. Ejecute docker image ls para verificar el nombre si no está seguro.
Esto quitará el contenedor después de cada uso para que siempre tengas un ambiente fresco para que funcione. Si configura una canalización ci-cd para crear automáticamente el contenedor, también puede agregar un indicador --pull=newer para que cuando lo ejecute, Docker verifique si hay un contenedor más nuevo y lo descargue antes de ejecutarlo.
ventana acoplable ejecutar --rm -v $HOME/Downloads/:/gallery-dl/ -v $HOME/.config/gallery-dl/gallery-dl.conf:/etc/gallery-dl.conf -it gallery-dl: el último
También puede agregar un alias a su shell para "gallery-dl" o crear un script bash simple y soltarlo en algún lugar de su $PATH para que actúe como un shim para este comando.
Para usar gallery-dl simplemente llámalo con las URL desde las que deseas descargar imágenes:
galería-dl [OPCIONES]... URL...
Utilice gallery-dl --help o consulte docs/options.md para obtener una lista completa de todas las opciones de la línea de comandos.
Descargar imágenes; en este caso de danbooru mediante la búsqueda de etiquetas para 'bonocho':
galería-dl "https://danbooru.donmai.us/posts?tags=bonocho"
Obtenga la URL directa de una imagen de un sitio que admita autenticación con nombre de usuario y contraseña:
galería-dl -g -u "<nombre de usuario>" -p "<contraseña>" "https://twitter.com/i/web/status/604341487988576256"
Filtrar capítulos de manga por número de capítulo e idioma:
gallery-dl --chapter-filter "10 <= capítulo < 20" -o "lang=fr" "https://mangadex.org/title/59793dd0-a2d8-41a2-9758-8197287a8539"
Busque URL en un recurso remoto y descargue imágenes de ellas:
(Las URL para las que no se pueda encontrar ningún extractor se ignorarán silenciosamente)
galería-dl "r:https://pastebin.com/raw/FLwrCYsT"
Si la dirección de un sitio no es estándar para su extractor, puede anteponer a la URL el nombre del extractor para forzar el uso de un extractor específico:
galería-dl "tumblr:https://alguntumblrblog.ejemplo"
Los archivos de configuración para gallery-dl utilizan un formato de archivo basado en JSON.
Puede encontrar una lista de todas las opciones de configuración disponibles y sus descripciones en https://gdl-org.github.io/docs/configuration.html.
Para obtener un archivo de configuración predeterminado con las opciones disponibles establecidas en sus valores predeterminados, consulte docs/gallery-dl.conf.
Para ver un ejemplo comentado con configuraciones más complicadas y uso de opciones, consulte docs/gallery-dl-example.conf.
gallery-dl busca archivos de configuración en los siguientes lugares:
Ventanas:
( %USERPROFILE% generalmente se refiere al directorio de inicio de un usuario, es decir, C:Users<username> )
%APPDATA%gallery-dlconfig.json
%USERPROFILE%gallery-dlconfig.json
%USERPROFILE%gallery-dl.conf
Linux, macOS, etc.:
/etc/gallery-dl.conf
${XDG_CONFIG_HOME}/gallery-dl/config.json
${HOME}/.config/gallery-dl/config.json
${HOME}/.gallery-dl.conf
Cuando se ejecuta como ejecutable, gallery-dl también buscará un archivo gallery-dl.conf en el mismo directorio que dicho ejecutable.
Es posible utilizar más de un archivo de configuración a la vez. En este caso, cualquier valor de los archivos posteriores al primero se fusionará con la configuración ya cargada y potencialmente anulará los anteriores.
Algunos extractores requieren que proporciones credenciales de inicio de sesión válidas en forma de un par de nombre de usuario y contraseña. Esto es necesario para nijie y opcional para aryion , danbooru , e621 , exhentai , idolcomplex , imgbb , inkbunny , mangadex , mangoxo , pillowfort , sankaku , subscribestar , tapas , tsumino , twitter y zerochan .
Puede configurar la información necesaria en su archivo de configuración.
{ "extractor": { "twitter": { "nombre de usuario": "<nombre de usuario>", "contraseña": "<contraseña>"
}
}
} o puede proporcionarlos directamente a través de -u/--username y -p/--password o mediante las opciones de línea de comandos -o/--option
gallery-dl -u "<nombre de usuario>" -p "<contraseña>" "URL"gallery-dl -o "nombre de usuario=<nombre de usuario>" -o "contraseña=<contraseña>" "URL"
Para los sitios donde no es posible iniciar sesión con nombre de usuario y contraseña debido a CAPTCHA o similar, o donde aún no se ha implementado, puede usar las cookies desde una sesión de inicio de sesión del navegador e ingresarlas en gallery-dl .
Esto se puede hacer a través de la opción de cookies en su archivo de configuración especificando
la ruta a un archivo cookies.txt en formato Mozilla/Netscape exportado por un complemento del navegador
(por ejemplo, obtener cookies.txt LOCALMENTE para Chrome, exportar cookies para Firefox)
una lista de pares nombre-valor recopilados de las herramientas de desarrollo web de su navegador
(en Chrome, en Firefox)
el nombre de un navegador para extraer las cookies
(Los navegadores compatibles son los basados en Chromium, Firefox y Safari)
Por ejemplo:
{ "extractor": { "instagram": { "cookies": "$HOME/ruta/a/cookies.txt"
}, "patreon": { "cookies": { "session_id": "K1T57EKu19TR49C51CDjOJoXNQLF7VbdVOiBrC9ye0a"
}
}, "twitter": { "cookies": ["firefox"]
}
}
} También puede especificar un archivo cookies.txt con la opción de línea de comandos --cookies
o un navegador para extraer cookies con --cookies-from-browser :
galería-dl --cookies "$HOME/ruta/a/cookies.txt" "URL"galería-dl --cookies-del-navegador firefox "URL"
gallery-dl admite la autenticación de usuarios a través de OAuth para algunos extractores. Esto es necesario para pixiv y opcional para las instancias de deviantart , flickr , reddit , smugmug , tumblr y mastodon .
Vincular su cuenta a gallery-dl le otorga la capacidad de emitir solicitudes en nombre de su cuenta y le permite acceder a recursos que de otro modo no estarían disponibles para un usuario público.
Para hacerlo, comience invocándolo con oauth:<sitename> como argumento. Por ejemplo:
galería-dl oauth: flickr
Se le enviará a la página de autorización del sitio y se le pedirá que otorgue acceso de lectura a gallery-dl . Autorícelo y se le mostrarán uno o más "tokens", que deben agregarse a su archivo de configuración.
Para autenticarse con una instancia mastodon , ejecute gallery-dl con oauth:mastodon:<instance> como argumento. Por ejemplo:
galería-dl oauth:mastodonte:pawoo.net galería-dl oauth:mastodon:https://mastodon.social/
