Metadata-Version: 2.4
Name: deviantart-gallery-downloader
Version: 1.0.0
Summary: Descarga galerías completas de DeviantArt usando la API pública oficial
Author-email: Sergio Rodríguez <srodriguez3441@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/nibblex/DeviantartDownloader
Project-URL: Repository, https://github.com/nibblex/DeviantartDownloader
Keywords: deviantart,downloader,gallery,art,scraper
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Multimedia :: Graphics
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25
Dynamic: license-file

# DeviantArt Downloader

Descarga la galería completa de cualquier perfil de DeviantArt usando la [API pública oficial](https://www.deviantart.com/developers/).

- Descarga el archivo original cuando el autor lo permite, o la imagen a máxima resolución pública.
- Descargas en paralelo con reintentos y manejo del límite de peticiones de la API.
- Detecta duplicados entre ejecuciones (aunque la obra haya cambiado de título), así que es seguro relanzarlo para sincronizar novedades.
- Guarda los metadatos completos de cada obra en `_metadata.json`.

## Instalación

```bash
pip install deviantart-gallery-downloader
```

## Credenciales

1. Crea una cuenta de DeviantArt.
2. Registra una aplicación (tipo *confidential*) en <https://www.deviantart.com/developers/register>.
3. Copia el `client_id` y `client_secret` desde <https://www.deviantart.com/developers/apps>.

Expórtalas como variables de entorno o ponlas en un archivo `.env` en el directorio desde el que ejecutes el comando:

```bash
DA_CLIENT_ID=tu_client_id
DA_CLIENT_SECRET=tu_client_secret
# Opcional: descargas simultáneas (default: 4, recomendado no superar 8)
DA_WORKERS=4
```

## Uso

```bash
deviantart-downloader https://www.deviantart.com/nombreusuario
deviantart-downloader nombreusuario

# Pasando las credenciales por argumento:
deviantart-downloader nombreusuario --client-id XXX --client-secret YYY

# Opciones útiles:
deviantart-downloader nombreusuario -o mi_carpeta   # carpeta de salida (default: downloads)
deviantart-downloader nombreusuario -w 8            # descargas simultáneas
deviantart-downloader nombreusuario --delay 1.0     # pausa tras cada descarga, por hilo
```

Los archivos se guardan en `<salida>/<usuario>/`.

## Licencia

MIT
