Files
manga-mass-downloader/README.md
renato97 829996b41e Initial commit: Manga Mass Downloader Chrome Extension
 Features:
- Multi-selection checkboxes on manga listings
- Batch download selected manga or all manga from page
- Optimized parallel downloading (20ms delays, 5 concurrent)
- Visual progress tracking
- Popup UI for easy control
- Fixed duplicate checkbox issue with deduplication logic

📁 Files:
- manifest.json: Extension configuration
- content.js: Checkbox injection & manga detection
- background.js: Optimized download engine
- popup.html/js: User interface
- README.md: Complete documentation
2025-11-04 04:25:25 +00:00

108 lines
3.7 KiB
Markdown

# Manga Mass Downloader
Chrome Extension para descarga masiva de manga desde listados de e-hentai.org
## ✨ Características
-**Selección múltiple**: Agrega checkboxes a cada miniatura de manga
-**Descarga individual**: Selecciona 5-10 manga y descárgalos uno por uno
-**Descarga masiva**: Descarga TODOS los manga de una página de una vez
-**Basado en addon optimizado**: Utiliza el motor de descarga paralelo ultra-rápido
-**Barra de progreso**: Visualiza el progreso en tiempo real
-**Interfaz intuitiva**: Popup con controles fáciles de usar
## 🚀 Cómo usar
### 1. Instalación
- Ve a `chrome://extensions/`
- Activa "Modo de desarrollador"
- Carga la carpeta del addon
### 2. Seleccionar Manga
- Ve a https://e-hentai.org/?f_cats=1019&f_search=spanish (o cualquier listado)
- Las miniaturas tendrán un checkbox "Descargar" en la esquina superior izquierda
- Haz clic para seleccionar los manga que quieres
- Usa el botón "Seleccionar Todos" en la esquina inferior izquierda
### 3. Descargar
- Haz clic en el ícono del addon en la barra de herramientas
- **Opción 1**: "Descargar Seleccionados" - Descarga solo los marcados
- **Opción 2**: "Descargar TODOS de la Página" - Descarga todos los manga visibles
- **Opción 3**: "Limpiar Selección" - Deselecciona todo
## 📁 Estructura del proyecto
```
mass-downloader/
├── manifest.json # Configuración de la extensión
├── content.js # Content script para detectar miniaturas
├── background.js # Service worker para descargas (optimizado)
├── popup.html # Interfaz del popup
├── popup.js # Lógica del popup
├── jszip.min.js # Librería para crear archivos ZIP
└── README.md # Este archivo
```
## 🎯 Funcionamiento
### Content Script (`content.js`)
- Detecta miniaturas de manga en la página
- Agrega checkboxes interactivos
- Extrae metadata (título, ID, token, URL)
- Permite selección múltiple
### Background Script (`background.js`)
- Descarga imágenes en lotes paralelos (5 simultáneas)
- Delay fijo de 20ms entre descargas
- Crea archivos ZIP optimizados
- Basado en el addon original ultra-optimizado
### Popup (`popup.html` + `popup.js`)
- Contador de manga seleccionados
- 3 botones principales de descarga
- Barra de progreso visual
- Feedback de estado en tiempo real
## ⚡ Optimizaciones
- **Velocidad extrema**: Descarga en paralelo con delays mínimos
- **Rate limiting controlado**: 20ms delay fijo
- **Validación robusta**: Filtra imágenes válidas
- **Compresión ZIP**: Nivel 6 DEFLATE para mejor ratio
- **Nombres limpios**: Sanitización de títulos
## 🔧 Diferencias con el addon original
| Característica | Manga Downloader | Manga Mass Downloader |
|---|---|---|
| **Página objetivo** | Páginas de galería (`/g/`) | Listados de manga |
| **Selección** | Un manga a la vez | Múltiples manga |
| **Descarga** | Individual | Individual y masiva |
| **UI** | Botón flotante | Popup + checkboxes |
| **Scope** | Manga específico | Lista de manga |
## 📝 Notas
- Solo funciona en e-hentai.org y exhentai.org
- Requiere credenciales de sesión (cookie de login)
- Cada descarga abre un diálogo de "Guardar como"
- Las descargas se procesan secuencialmente para evitar saturar el servidor
## 🐛 Solución de problemas
**No aparecen los checkboxes:**
- Recarga la página
- Verifica que estés en una página de listado (no en `/g/`)
**Error al descargar:**
- Verifica que estés logueado en e-hentai
- Revisa la consola (F12) para logs detallados
**Descarga muy lenta:**
- Es normal, se procesa secuencialmente
- Las primeras descargas tardan más
## 📄 Licencia
MIT License - Uso personal